язык: примеры переведены на вымышленные X-правила

- живые идентификаторы KEYS-5, SLOG-8.1, SLOG-27, MIGR-2/4/6 в примерах
  заменены на XKEY, XMIG, XLOG: номера канона означали не то, что в примере,
  и расходились дальше при каждой перенумерации
- сказано явно, что описание языка ни на один набор конвенций не опирается;
  ссылка на обоснования канона в разделе про ПОЧЕМУ заменена на внешние
  практики

TODO.md

@@ -4,31 +4,12 @@
 решения. Закрытый вопрос отсюда удаляется — принятое решение живёт в
 `README.md`, `GUIDE.md` или `LANGUAGE.md`, а не в этом файле.
 
-Две секции: сначала язык и подход, потом канон с тулингом. Пункты 1–7
+Две секции: сначала язык и подход, потом канон с тулингом. Пункты 1–6
 пришли из внешнего ревью описания языка и проверены по файлам на месте.
 
 # Язык и подход
 
-## 1. Примеры в LANGUAGE.md сидят на живых идентификаторах
-
-Учебные примеры используют настоящие префиксы канона с номерами, которые в
-каноне означают другое:
-
-| В примере `LANGUAGE.md` | В каноне на самом деле |
-|---|---|
-| `MIGR-4` проверяет `AUTOINCREMENT` в новых миграциях | MIGR-4 — «В деплое схема движется только вперёд»; про AUTOINCREMENT — MIGR-12 |
-| «MIGR-6. Дефолтов времени в схеме БД нет» | MIGR-6 — «ER-схема обновляется в том же изменении»; дефолты — MIGR-9 |
-| «KEYS-5. Разбор внешнего идентификатора на границе» | KEYS-5 — «Внешний идентификатор разбирается до обращения к базе», с другим текстом нормы |
-
-Язык держится на том, что идентификатор адресует ровно одно утверждение, и
-документ, определяющий язык, это нарушает. Ни одна проверка не поймает —
-идентификаторы существуют. Дрейф вдобавок гарантирован: канон
-перенумеровывался, примеры не двигались.
-
-Лечится дёшево: примеры берут префиксы на `X`, зарезервированные как раз под
-то, что каноном не занято.
-
-## 2. «Тема» — несущий идентификатор без определения и реестра
+## 1. «Тема» — несущий идентификатор без определения и реестра
 
 META-21 велит ссылаться на соседнюю конвенцию именем темы, манифест
 подписывается `topics = ["time", …]`, сборка собирает файл темы из слоёв —
@@ -41,13 +22,13 @@ META-21 велит ссылаться на соседнюю конвенцию
 файла темы тихо осиротит все текстовые ссылки во всех копиях.
 
 Вопрос уже не гипотетический: пара `arch/db-identifiers.md` против
-`lang/go/db-schema.md` (см. вопрос 11) показывает, что имена слоёв одной
+`lang/go/db-schema.md` (см. вопрос 10) показывает, что имена слоёв одной
 темы могут не совпадать. Смежно: `extends: arch/time.md` у SLOG ломает
 гарантию META-24 («базовый слой отсутствовать не может») — она верна только
 для базы своей темы, а машинной проверке негде узнать тему, кроме имени
 файла.
 
-## 3. GUIDE выведен из-под проверок ложным основанием
+## 2. GUIDE выведен из-под проверок ложным основанием
 
 `LANGUAGE.md` исключает обвязку из проверок формулировкой «она ключевые слова
 цитирует, а не употребляет». Для `GUIDE.md` это неверно: META-правила
@@ -63,7 +44,7 @@ META-21 велит ссылаться на соседнюю конвенцию
 Честнее развести: `GUIDE.md` язык **употребляет** и проверяется как
 конвенция, `LANGUAGE.md` и `README.md` — цитируют.
 
-## 4. МЕХАНИЗИРОВАНО не переживает нового подписчика
+## 3. МЕХАНИЗИРОВАНО не переживает нового подписчика
 
 META-8 запрещает удалять норму, пока механизирована не у всех, и защищает
 тем самым потребителей, существующих **на момент удаления**. Будущих не
@@ -81,7 +62,7 @@ META-8 запрещает удалять норму, пока механизир
 в тексте канона, то есть ровно то, что запрещает META-4. Либо это законное
 исключение, и тогда его надо назвать, либо конфликт.
 
-## 5. Семантика ключевых слов в копию не едет
+## 4. Семантика ключевых слов в копию не едет
 
 Строка о версии языка перечисляет слова, но не их значения, а всё
 нетривиальное в шкале живёт только в `LANGUAGE.md`, который в репозиторий не
@@ -97,7 +78,7 @@ META-8 запрещает удалять норму, пока механизир
 копиями короткую выжимку семантики; расширить строку о версии до
 двух-трёх предложений; или признать ограничение и записать его явно.
 
-## 6. Две «механические» проверки без источника данных
+## 5. Две «механические» проверки без источника данных
 
 В списке «разбором текста» стоят два пункта, которые без дополнительного
 реестра нерешаемы:
@@ -113,7 +94,7 @@ META-8 запрещает удалять норму, пока механизир
 реестр снятых номеров не объявлен частью языка, оба пункта принадлежат
 списку «чтением».
 
-## 7. Натяжки в опоре на стандарты
+## 6. Натяжки в опоре на стандарты
 
 Три места, где источнику приписано чуть больше, чем в нём есть:
 
@@ -132,7 +113,7 @@ META-8 запрещает удалять норму, пока механизир
 Остальное в таблице проверку выдержало, включая вторую половину `MAY` из
 BCP 14 и списки эквивалентных словесных форм ISO Directives.
 
-## 8. Одиннадцать таблиц не прочитаны на взаимоисключительность
+## 7. Одиннадцать таблиц не прочитаны на взаимоисключительность
 
 `LANGUAGE.md` объявил, что строки таблицы решений взаимоисключающи по
 умолчанию, а иной порядок объявляется явно. Объявление не делает таблицы
@@ -147,7 +128,7 @@ BCP 14 и списки эквивалентных словесных форм IS
 Работа читательская, машине не даётся; в список проверок она уже записана в
 разделе «Чтением, потому что машине не даётся».
 
-## 9. Описание языка отдельно от набора конвенций
+## 8. Описание языка отдельно от набора конвенций
 
 `LANGUAGE.md` и `GUIDE.md` описывают, **как** пишутся конвенции;
 `conventions/` — **один конкретный** набор. Сейчас они склеены в одном
@@ -156,7 +137,9 @@ BCP 14 и списки эквивалентных словесных форм IS
 
 Срочности нет: версия языка объявлена в самом `LANGUAGE.md` (ключ
 `version:`), и конвенции ссылаются на неё номером, а не путём, — то есть
-самодостаточность копии выноса не требует.
+самодостаточность копии выноса не требует. Примеры в `LANGUAGE.md` вдобавок
+переведены на вымышленные `X`-правила, так что на конкретный набор описание
+языка больше не ссылается вовсе.
 
 Что осталось поводом:
 
@@ -170,7 +153,7 @@ BCP 14 и списки эквивалентных словесных форм IS
 
 # Канон, тулинг, подключение
 
-## 10. Тулинг: две разные задачи в одном `conv`
+## 9. Тулинг: две разные задачи в одном `conv`
 
 Сейчас в `conv` смешаны две категории работы, и они расходятся по всему —
 по частоте запуска, по тому, кто запускает, и по тому, что считается
@@ -201,7 +184,7 @@ BCP 14 и списки эквивалентных словесных форм IS
   ссылках: это установка, а не целостность, но список подписок ему нужен из
   манифеста.
 
-Часть проверок из этого списка сейчас нереализуема по причине из вопроса 6,
+Часть проверок из этого списка сейчас нереализуема по причине из вопроса 5,
 так что порядок такой: сначала язык, потом чекер.
 
 Перед тем как переписывать, стоит посмотреть на два готовых прототипа:
@@ -209,14 +192,14 @@ BCP 14 и списки эквивалентных словесных форм IS
 манифеста и `vendir.yml` — как пример того, где проходит граница между «чего
 хочу» и «что получил».
 
-## 11. Пары слоёв и темы без базы
+## 10. Пары слоёв и темы без базы
 
 Отложено сознательно, но список стоит держать перед глазами:
 
 - `SLOG` объявляет `extends: arch/time.md` — расширение **чужой** темы.
   Сборщик темы `logging` на это наткнётся: базового слоя с темой `logging`
   нет, а `arch/time.md` он тянуть не должен. Чинится переводом в обычную
-  ссылку «связано». Вдобавок это ломает гарантию META-24 — см. вопрос 2.
+  ссылку «связано». Вдобавок это ломает гарантию META-24 — см. вопрос 1.
 - Темы без арх-слоя: `db-schema`, `errors`, `web-ui`. Собираются в файл с
   одной секцией — само по себе не ломается, но это и есть тот невыделенный
   арх-слой из известного долга.
@@ -228,7 +211,7 @@ BCP 14 и списки эквивалентных словесных форм IS
 - Вынос арх-ядра из `errors` и `logging` закроет две хрупкие ссылки из
   `web-ui` (стек) в go-слой — единственные ссылки стек → язык в каноне.
 
-## 12. Подключение к репозиториям
+## 11. Подключение к репозиториям
 
 Ничего ещё не подключено. Кандидаты — jellybit и pet-project-server.
 Понадобится: заполнить локальную часть копий тем, что сейчас в этих
@@ -237,7 +220,7 @@ BCP 14 и списки эквивалентных словесных форм IS
 строка в `AGENTS.md` каждого потребителя про то, что файлы в
 `docs/conventions/` — копии.
 
-## 13. Тулинг на Go, живущий независимо
+## 12. Тулинг на Go, живущий независимо
 
 Сейчас `conv` — питоновский скрипт внутри канона, то есть тулинг и данные в
 одном репозитории и правятся одним движением. Мысль: вынести в отдельный
@@ -246,10 +229,10 @@ Go-бинарь со своим релизным циклом, ставить ч
 
 Что за этим стоит помимо вкуса: независимый бинарь физически не даёт править
 инструмент «заодно» с правкой конвенции, работает против **любого** канона и
-любого потребителя — что прямо требуется вопросом 9, — и снимает питон из
+любого потребителя — что прямо требуется вопросом 8, — и снимает питон из
 зависимостей репозиториев-потребителей.
 
-Порядок обратный ожидаемому: пока вопрос 9 не сделан, инструмент всё равно
+Порядок обратный ожидаемому: пока вопрос 8 не сделан, инструмент всё равно
 работает против одного конкретного канона, и независимый релизный цикл ему
-нечего обслуживать. Сначала 9, потом 13. Разделение из вопроса 10 при этом
+нечего обслуживать. Сначала 8, потом 12. Разделение из вопроса 9 при этом
 дешевле заложить сразу, чем отпиливать потом.