Что такое «Руководство по стилю»
Когда над сайтом работают несколько человек, без общих договорённостей каждый пишет по-своему: один ставит табы, другой пробелы, у одной кнопки скругление 4 пикселя, у другой 8, а одна и та же сущность в текстах называется то «заказом», то «заявкой». Руководство фиксирует решения один раз, и спорить о них на каждой задаче больше не нужно — это лучшее лекарство от bikeshedding.
Документ бывает трёх видов, и в крупных проектах они живут рядом. Руководство по коду описывает форматирование, именование классов и функций, структуру файлов. Дизайн-руководство — палитру, шрифты, сетку, состояния кнопок и полей. Редакционное — тон, написание терминов, правила для цифр и дат.
Что обычно входит
- Правила форматирования и именования: например, методология БЭМ для классов CSS.
- Палитра и типографика с конкретными значениями, а не «фирменный синий».
- Каталог компонентов интерфейса с примерами и всеми состояниями.
- Словарь терминов и запретных слов для текстов.
Как закрепить правила в коде
Правило, которое проверяет машина, соблюдается лучше, чем правило в документе. Базовые договорённости о форматировании кладут в файл .editorconfig в корне проекта — его понимает большинство редакторов:
root = true
[*]
charset = utf-8
end_of_line = lf
indent_style = space
indent_size = 2
[*.php]
indent_style = tab
Дальше подключают линтеры: stylelint для CSS, ESLint для JavaScript, PHP_CodeSniffer для PHP. Для тем и плагинов WordPress есть готовый набор правил WordPress Coding Standards, в котором, к слову, отступы в PHP делаются табами.
Типичные ошибки
- Документ на сто страниц, который никто не открывает. Работает короткий текст плюс автоматические проверки.
- Руководство расходится с реальным кодом. Живое руководство, собранное из тех же компонентов, что и сайт, устаревает медленнее.
- Нет владельца: правила меняют все понемногу, и через год их снова приходится согласовывать.
Связанные термины
Обновлено: 10 октября 2026

