guide: заведён META-26 — обоснование объясняет, а не требует
- «Почему» не пересказывает норму словами обязательства: у оригинала есть идентификатор, у копии нет, и расходятся они при первой правке оригинала, а отступление от копии адресовать нечем - модальность рекомендательная по META-6: греп находит слово, а не нарушение — «за попыткой следует повтор» и «становится обязанностью вызывающего» описывают ход событий; утверждения о невозможности («нельзя») правилом не затрагиваются, это ISO-евская возможность в прозе - SLOG-12 починен: факт о том, что `slog` не разделяет CRITICAL и FATAL, уехал из нормы в «Почему», а норма теперь говорит то же, что заголовок
This commit is contained in:
@@ -232,6 +232,25 @@ prefix: META
|
||||
существует. Без обоснования не видно, когда причина отпала, — проверка
|
||||
продолжает работать по инерции, и возразить ей нечем, кроме как отключив.
|
||||
|
||||
### META-26. Обоснование объясняет, а не требует
|
||||
|
||||
**НЕ СЛЕДУЕТ.** Абзац «Почему» не повторяет норму словами обязательства — на
|
||||
ту норму, на которую он опирается, ссылаются идентификатором.
|
||||
|
||||
**Почему.** Обоснование, сформулированное как требование, заводит вторую
|
||||
копию нормы: у оригинала есть идентификатор, у копии нет, и расходятся они
|
||||
при первой же правке оригинала. Читатель не отличает объяснение от
|
||||
досказанной нормы, а отступление от копии не адресуемо — ссылаться на абзац
|
||||
нечем.
|
||||
|
||||
Утверждения о невозможности («нельзя», «не выйдет») сюда не относятся: они
|
||||
описывают, чего не бывает, а не то, что запрещено, и проза — их законное
|
||||
место. Модальность здесь рекомендательная не по слабости, а по META-6:
|
||||
машинная проверка даёт кандидатов, а не вердикт, потому что слова
|
||||
омонимичны — «за попыткой следует повтор» и «присвоение становится
|
||||
обязанностью каждого вызывающего» описывают ход событий. Вердикт остаётся за
|
||||
чтением, грепу достаётся роль подсказки.
|
||||
|
||||
### META-11. У трудноизменяемого слоя область действия пишется явно
|
||||
|
||||
**ДОЛЖЕН.** Конвенция о схеме БД, формате хранения или раскладке директорий
|
||||
|
||||
Reference in New Issue
Block a user