guide: META-26 снят, форма обоснования рамками не ограничивается
- запрет слов обязательства в «Почему» был лишним по построению: правило о заглавных уже делает строчное «обязан» ненормативным, так что второй копии нормы не возникает, а цена — автор воюет со списком слов вместо объяснения - в LANGUAGE записано прямо: рамки у обоснования только смысловые, длина, рассуждение, примеры и ссылки на внешние практики и чужие проекты допустимы - заведён раздел «Освободившиеся номера»: META-16 и META-26 с причинами. Без такого списка упоминание номера в прозе не отличить от ссылки на исчезнувшее правило — это же нужно будущей проверке ссылок
This commit is contained in:
@@ -36,8 +36,7 @@ prefix: META
|
||||
записано, и это случай META-25: регуляркой имя проверяется тривиально, но
|
||||
обоснование сводится к «чтобы имя файла в реестре префиксов писалось одним
|
||||
способом» — вреда от нарушения нет, значит и высшей модальности нет, а на
|
||||
СЛЕДУЕТ такое правило не окупает строчку. Номер META-16, под которым оно
|
||||
существовало, оставлен свободным и не переиспользуется.
|
||||
СЛЕДУЕТ такое правило не окупает строчку.
|
||||
|
||||
## Канон и копии
|
||||
|
||||
@@ -232,25 +231,6 @@ prefix: META
|
||||
существует. Без обоснования не видно, когда причина отпала, — проверка
|
||||
продолжает работать по инерции, и возразить ей нечем, кроме как отключив.
|
||||
|
||||
### META-26. Обоснование объясняет, а не требует
|
||||
|
||||
**НЕ СЛЕДУЕТ.** Абзац «Почему» не повторяет норму словами обязательства — на
|
||||
ту норму, на которую он опирается, ссылаются идентификатором.
|
||||
|
||||
**Почему.** Обоснование, сформулированное как требование, заводит вторую
|
||||
копию нормы: у оригинала есть идентификатор, у копии нет, и расходятся они
|
||||
при первой же правке оригинала. Читатель не отличает объяснение от
|
||||
досказанной нормы, а отступление от копии не адресуемо — ссылаться на абзац
|
||||
нечем.
|
||||
|
||||
Утверждения о невозможности («нельзя», «не выйдет») сюда не относятся: они
|
||||
описывают, чего не бывает, а не то, что запрещено, и проза — их законное
|
||||
место. Модальность здесь рекомендательная не по слабости, а по META-6:
|
||||
машинная проверка даёт кандидатов, а не вердикт, потому что слова
|
||||
омонимичны — «за попыткой следует повтор» и «присвоение становится
|
||||
обязанностью каждого вызывающего» описывают ход событий. Вердикт остаётся за
|
||||
чтением, грепу достаётся роль подсказки.
|
||||
|
||||
### META-11. У трудноизменяемого слоя область действия пишется явно
|
||||
|
||||
**ДОЛЖЕН.** Конвенция о схеме БД, формате хранения или раскладке директорий
|
||||
@@ -357,3 +337,14 @@ prefix: META
|
||||
идентификатором служит и напоминанием, и адресом, по которому за
|
||||
подробностями идут; перенос деталей туда же вернул бы задачу поддержки двух
|
||||
текстов.
|
||||
|
||||
## Освободившиеся номера
|
||||
|
||||
Номер удалённого правила не переиспользуется, поэтому дыры в нумерации —
|
||||
норма. Здесь перечислено, что́ под ними было: без этого упоминание номера в
|
||||
прозе не отличить от ссылки на исчезнувшее правило.
|
||||
|
||||
| Номер | Что было | Почему снято |
|
||||
|---|---|---|
|
||||
| META-16 | имя файла — kebab-case | вреда от нарушения нет (META-25); осталось прозой в «Оформлении» |
|
||||
| META-26 | запрет слов обязательства в «Почему» | правило о заглавных уже делает строчное слово ненормативным, а форму обоснования рамками не ограничивают |
|
||||
|
||||
Reference in New Issue
Block a user