ПОЧЕМУ стало ключевым словом, язык поднят до версии 2
- метка обоснования пишется заглавными и вошла в словарь набора: скелет правила теперь целиком из ключевых слов, а не смесь `**ДОЛЖЕН.**` и `**Почему.**`; в переводе на другой язык метка меняется как остальные слова (ПОЧЕМУ / WHY), 235 вхождений заменены - метки правила выделены из шкалы в отдельный перечень: ПОЧЕМУ и МЕХАНИЗИРОВАНО обязательности не задают, а размечают части, и стандартом не даются ни в одном языке — раньше МЕХАНИЗИРОВАНО висело строкой в таблице модальности - версия языка поднята до 2, потому что изменение формы меняет чтение уже написанного текста; строка о версии в двенадцати конвенциях перечисляет теперь и метки, а служебные слова сценария в неё по-прежнему не входят
This commit is contained in:
@@ -18,7 +18,7 @@ code in this repository.
|
||||
## Форма правила
|
||||
|
||||
- Четыре обязательные части: `### <ПРЕФИКС>-<N>. Заголовок`, абзац
|
||||
`**МОДАЛЬНОСТЬ.** норма`, абзац `**Почему.** …`. Правило без «Почему» не
|
||||
`**МОДАЛЬНОСТЬ.** норма`, абзац `**ПОЧЕМУ.** …`. Правило без обоснования не
|
||||
принимается.
|
||||
- Норма — одна фраза; если в неё не влезает, это два правила.
|
||||
- Шкала инвариантна, словарь — параметр языка набора. Канон русский, значит
|
||||
@@ -34,14 +34,17 @@ code in this repository.
|
||||
обсуждается.
|
||||
- **МЕХАНИЗИРОВАНО** — не модальность, а способ проверки: отметка стоит
|
||||
рядом с модальным словом (`**ДОЛЖЕН. МЕХАНИЗИРОВАНО.**`), а не вместо него.
|
||||
- Метки правила — **ПОЧЕМУ** и **МЕХАНИЗИРОВАНО** — тоже словарь набора и
|
||||
перечислены в строке о версии языка наравне с модальными словами.
|
||||
- Заглавные модальные слова не употребляются вне правил: ни в «Область
|
||||
действия», ни в «Связано», ни в локальной части копии, ни во вводной прозе.
|
||||
Исключение — строка о версии языка, которая их перечисляет.
|
||||
- «Почему» отвечает на «что сломается, если сделать иначе», а не
|
||||
- Обоснование отвечает на «что сломается, если сделать иначе», а не
|
||||
пересказывает норму. «Потому что так принято» — не обоснование.
|
||||
- Форма «Почему» не ограничена: рамки смысловые. Длина, рассуждение, примеры,
|
||||
ссылки на внешние практики и чужие проекты — всё допустимо; запрещённых слов
|
||||
нет. Обязательность несёт норма, и путаницу исключает правило о заглавных.
|
||||
- Форма обоснования не ограничена: рамки смысловые. Длина, рассуждение,
|
||||
примеры, ссылки на внешние практики и чужие проекты — всё допустимо;
|
||||
запрещённых слов нет. Обязательность несёт норма, и путаницу исключает
|
||||
правило о заглавных.
|
||||
- Служебные слова сценарного блока — тоже словарь набора: **КОГДА**,
|
||||
**ТОГДА**, **И**, **ИЛИ** (по-английски `WHEN`/`THEN`/`AND`/`OR`). Одна
|
||||
форма на роль, заглавными. Модальностью не являются, в строку о версии
|
||||
@@ -72,9 +75,9 @@ code in this repository.
|
||||
## Ссылки
|
||||
|
||||
- META-20: норму можно исполнить, имея один этот файл. Ссылка на правило
|
||||
чужой темы допустима в «Почему», в «Связано» и в разграничении области
|
||||
чужой темы допустима в обосновании, в «Связано» и в разграничении области
|
||||
действия — но не в самой норме. Нужен концепт соседней темы — коротко
|
||||
повторить его здесь, соседа назвать в «Почему».
|
||||
повторить его здесь, соседа назвать в обосновании.
|
||||
- META-21: на соседнюю конвенцию ссылаются именем темы (конвенция
|
||||
`logging`), на правило — идентификатором (`SLOG-27`). Пути файлов канона в
|
||||
тексте конвенции нет (в обвязке — можно).
|
||||
@@ -93,7 +96,7 @@ code in this repository.
|
||||
- META-6: ДОЛЖЕН без механической проверки либо механизируется, либо
|
||||
понижается в СЛЕДУЕТ. Правило, непроверяемое машиной в принципе (вкус
|
||||
формулировки, суждение о ситуации), — СЛЕДУЕТ по построению.
|
||||
- META-10: блок «Почему» не удаляется никогда, в том числе после того, как
|
||||
- META-10: блок ПОЧЕМУ не удаляется никогда, в том числе после того, как
|
||||
норма уехала в линтер.
|
||||
- META-1: один файл — ровно один повторяющийся выбор. META-2: конвенция
|
||||
заводится, когда решение принимается третий раз.
|
||||
|
||||
Reference in New Issue
Block a user