guide: заведён META-24 — ссылка слоя на идентификаторы своей базы
- языковой и стековый слои называют идентификатор правила арх-слоя своей темы прямо в норме: подписываются темой, а не слоем, поэтому базовый слой в собранной копии присутствует всегда и ссылка не ведёт в пустоту - разрешение узкое по построению — на слои других языков и стеков не распространяется, их состав в копии зависит от манифеста - из META-21 убрано предписание ссылаться на свой слой словами «базовый слой»: слова не проверяются и не ведут к утверждению, а идентификатор ведёт
This commit is contained in:
@@ -121,15 +121,30 @@ prefix: META
|
||||
### META-21. Ссылка ведёт на тему или на правило, но не на путь в каноне
|
||||
|
||||
**ДОЛЖЕН.** На соседнюю конвенцию ссылаются именем темы (конвенция
|
||||
`logging`), на конкретное правило — идентификатором (`SLOG-27`), на другой
|
||||
слой своей же темы — словами «базовый слой». Путь файла канона в тексте
|
||||
конвенции не употребляется.
|
||||
`logging`), на конкретное правило — идентификатором (`SLOG-27`); путь файла
|
||||
канона в тексте конвенции не употребляется.
|
||||
|
||||
**Почему.** В репозитории конвенция лежит собранной: слои одной темы — это
|
||||
секции одного файла, и пути `lang/go/logging.md` там не существует. Ссылка
|
||||
на путь канона умирает при сборке, причём молча — текст остаётся связным.
|
||||
Имя темы и идентификатор правила переживают и сборку, и переезд файла между
|
||||
осями.
|
||||
осями. Слой своей темы поэтому называют идентификатором его правила, а не
|
||||
словами «базовый слой»: слова не проверяются и не ведут к утверждению.
|
||||
|
||||
### META-24. Слой ссылается на идентификаторы своего базового слоя
|
||||
|
||||
**ДОПУСКАЕТСЯ.** Правило языкового или стекового слоя называет идентификатор
|
||||
правила арх-слоя своей темы прямо в норме.
|
||||
|
||||
**Почему.** Подписываются темой, а не слоем: собранный файл начинается с
|
||||
арх-слоя независимо от того, какие язык и стек выбраны, — базовое правило в
|
||||
копии всегда рядом, и ссылка на него никуда не ведёт. Повтор его концепта
|
||||
здесь заводил бы второй источник правды внутри одного документа: META-20
|
||||
требует повторять концепт там, где соседнего файла может не быть, а базовый
|
||||
слой отсутствовать не может. Остальные слои темы попадают в копию по
|
||||
манифесту, и такой гарантии у них нет — отсюда узость разрешения. Записано
|
||||
оно явно, потому что META-20 читают строже, чем он есть, и без этой строки
|
||||
базу дублируют без нужды.
|
||||
|
||||
### META-5. Расхождение кода с правилом — отступление, а не повод переписать правило
|
||||
|
||||
|
||||
Reference in New Issue
Block a user