язык: заведён блок ПРИМЕРЫ
- пятая, необязательная часть правила: код парой «плохо → хорошо» после обоснования; метка добавлена в словарь (EXAMPLES) и в строку о версии языка во всех тринадцати файлах - сказано, чем примеры не являются: требований в блоке нет, дословным сниппетом он не служит, при расхождении с нормой правят пример - READING.md обновлён по META-30, в машинные проверки добавлен порядок блоков, в читательские — что примеры норму не расширяют
This commit is contained in:
+8
-3
@@ -34,9 +34,10 @@ version: 1
|
||||
между ДОЛЖЕН и СЛЕДУЕТ — в том, чем платят за отклонение, а не в том,
|
||||
возможно ли оно.
|
||||
|
||||
Ещё три метки заглавными: **ПОЧЕМУ** открывает обоснование правила,
|
||||
**МЕХАНИЗИРОВАНО** стоит при записи о том, что правило проверяет линтер или
|
||||
скрипт, **СНЯТО** — на месте правила, которое убрали.
|
||||
Ещё четыре метки заглавными: **ПОЧЕМУ** открывает обоснование правила,
|
||||
**ПРИМЕРЫ** — код, показывающий норму в деле, **МЕХАНИЗИРОВАНО** стоит при
|
||||
записи о том, что правило проверяет линтер или скрипт, **СНЯТО** — на месте
|
||||
правила, которое убрали.
|
||||
|
||||
Заглушка со СНЯТО занимает место убранного правила вместе с его номером:
|
||||
так нумерация остаётся сплошной, а ссылка на снятое правило приводит к
|
||||
@@ -80,6 +81,10 @@ version: 1
|
||||
- **ПОЧЕМУ.** Зачем правило существует и что сломается, если сделать иначе.
|
||||
Обоснование ничего не требует — по нему решают, применимо ли правило к
|
||||
случаю, и видно, когда причина отпала.
|
||||
- **ПРИМЕРЫ** — необязательный последний блок: код, обычно парой «плохо →
|
||||
хорошо». Иллюстрация, а не спецификация: деталь примера требованием не
|
||||
становится, дословно копировать его не нужно, а если пример разошёлся с
|
||||
нормой — действует норма.
|
||||
|
||||
**Правило кончается перед следующим заголовком.** Абзацы после ПОЧЕМУ — это
|
||||
продолжение обоснования: примеры, разбор границ, ссылки на внешние практики.
|
||||
|
||||
Reference in New Issue
Block a user