Руководство по стилю¶

Руководство по стилю (style guide) — свод правил и рекомендаций, определяющих единообразие оформления, изложения и терминологии в текстах организации, издания или проекта. Руководства по стилю применяются в редакциях, технической документации, программной разработке и корпоративных коммуникациях, обеспечивая согласованность материалов, создаваемых разными авторами.

¶Назначение и область применения

Основная задача руководства по стилю — снизить субъективность редакторских решений и сделать результат предсказуемым. Документ фиксирует нормы орфографии и пунктуации, правила употребления терминов, имен собственных, сокращений, дат, единиц измерения, а также требования к структуре текста, тону изложения и оформлению ссылок.

В русскоязычной практике базовые нормы закреплены в академических словарях и справочниках («Русский орфографический словарь», «Русское речевое этикет», справочник Розенталя «Справочник по русскому языку»), однако каждое издание или организация дополняет их собственными правилами.

¶Классификация

Руководства по стилю принято разделять по области применения:

¶Структура документа

Типовое руководство по стилю включает следующие разделы:

• Терминология — утверждённые написания и переводы терминов, запрещённые синонимы.
• Орфография и пунктуация — правила переносов, кавычек, тире, дефисов, написания сложных слов.
• Имена собственные — транскрипции, порядок имени и фамилии, титулы.
• Числа и даты — арабские или римские цифры, формат дат, единицы измерения.
• Тон и голос — допустимые обращения к читателю, степень формальности, избегание канцелярита.
• Оформление — заголовки, списки, таблицы, ссылки, сноски.

¶История

Практика унификации издательских правил возникла в XIX веке вместе с развитием массовой печати. В США первые своды появились в газетных редакциях: Associated Press Stylebook впервые выпущен в 1953 году и с тех пор ежегодно обновляется. В Великобритании аналогичную роль играет «Guardian and Observer Style Guide».

В России стандартизация речи долгое время опиралась на академические грамматики и словари; отдельные редакционные инструкции существовали при крупных издательствах и информационных агентствах. С развитием интернет-СМИ и технической документации в 2000-х годах российские компании и медиа начали разрабатывать собственные руководства по стилю, ориентируясь на зарубежный опыт.

¶Примеры руководств

• «Стиль» Льва Успенского (1971) — классический русский справочник, разъясняющий происхождение и употребление слов.
• Руководство по стилю Википедии — свод правил оформления статей энциклопедии.
• Google Developer Documentation Style Guide — регламентирует технические тексты для разработчиков.
• Microsoft Writing Style Guide — рекомендации по написанию документации и интерфейсов.
• PEP 8 — руководство по стилю языка Python, принятое сообществом в 2001 году.

¶Роль в программной разработке

В разработке программного обеспечения руководства по стилю кода (style guides) регламентируют форматирование отступов, длину строк, именование переменных и функций, расположение фигурных скобок. Единый стиль упрощает чтение и ревизию кода при командной работе. Помимо PEP 8, известны Google Java Style Guide, Airbnb JavaScript Style Guide, «Кодогид» Яндекса.

¶См. также

• Редактура
• Терминология
• Грамматика

¶Источники

• Розенталь Д. Э. «Справочник по русскому языку: орфография и пунктуация»
• Chicago Manual of Style, 17th edition
• Associated Press Stylebook
• Microsoft Writing Style Guide
• Google Developer Documentation Style Guide
• PEP 8 — Style Guide for Python Code