From 840904d454c4dda4dae9f00ec5cca86e8ebd9c04 Mon Sep 17 00:00:00 2001 From: Anton Vakhrushev Date: Sat, 25 Jul 2026 20:57:54 +0300 Subject: [PATCH] =?UTF-8?q?=D1=80=D0=B5=D0=B5=D1=81=D1=82=D1=80=20=D0=BF?= =?UTF-8?q?=D1=80=D0=B5=D1=84=D0=B8=D0=BA=D1=81=D0=BE=D0=B2=20=D0=BF=D0=B5?= =?UTF-8?q?=D1=80=D0=B5=D0=BD=D0=B5=D1=81=D1=91=D0=BD=20=D0=B2=20=D0=BA?= =?UTF-8?q?=D0=BE=D1=80=D0=B5=D0=BD=D1=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - реестр покрывает и обвязку тоже (GUIDE.md), поэтому внутри conventions/ он упирался в путь `../GUIDE.md`; теперь пути даются от корня репозитория - README дополнен разделом про префиксы и строкой в таблице обвязки --- LANGUAGE.md | 2 +- README.md | 14 +++++------ conventions/prefixes.toml => prefixes.toml | 29 ++++++++++++---------- 3 files changed, 24 insertions(+), 21 deletions(-) rename conventions/prefixes.toml => prefixes.toml (77%) diff --git a/LANGUAGE.md b/LANGUAGE.md index 48eeec0..f6bfbe6 100644 --- a/LANGUAGE.md +++ b/LANGUAGE.md @@ -99,7 +99,7 @@ - **Идентификаторы стабильны и не переиспользуются.** Удалённое правило оставляет дыру в нумерации; занимать её новым нельзя — иначе ссылка из чужого репозитория начнёт указывать на другое утверждение. То же - относится к префиксам: выбывшие хранит `conventions/prefixes.toml`. + относится к префиксам: выбывшие хранит `prefixes.toml`. - Префикс **выбирается под файл, а не выводится по формуле**: он нужен, чтобы по нему искать, а не чтобы его разбирать. Выводимый префикс вдобавок привязал бы идентификатор к таксономии, которую канон перестраивает, и diff --git a/README.md b/README.md index e148303..55b8ef5 100644 --- a/README.md +++ b/README.md @@ -10,8 +10,9 @@ | Файл | Что описывает | |---|---| | `README.md` | устройство канона, оси, синхронизация, жизненный цикл | -| [LANGUAGE.md](LANGUAGE.md) | язык записи правил: номера, модальность, «Почему» | +| [LANGUAGE.md](LANGUAGE.md) | язык записи правил: идентификаторы, модальность, «Почему» | | [GUIDE.md](GUIDE.md) | как ведут конвенции: когда заводить, механизация, отступления | +| `prefixes.toml` | реестр префиксов правил | | `conv` | синхронизация копий | Обвязка живёт только в каноне и в репозитории не оказывается — `conv` @@ -53,8 +54,8 @@ conventions/ Пути **файлов** даются относительно `conventions/`: `arch/db-identifiers.md`, а не `conventions/arch/…` — так же, как они лягут в `docs/conventions/` репозитория. На **правила** ссылаются идентификатором без пути: `KEYS-5`. -Префикс уникален по всему канону (реестр — `conventions/prefixes.toml`), -поэтому идентификатор не зависит от того, на какой оси файл лежит сегодня. +Префикс уникален по всему канону (реестр — `prefixes.toml`), поэтому +идентификатор не зависит от того, на какой оси файл лежит сегодня. Тест — по тому, замена чего убивает правило: @@ -88,10 +89,9 @@ prefix: KEYS ``` Четыре заглавные латинские буквы, уникальные по всему канону; реестр — -[`conventions/prefixes.toml`](conventions/prefixes.toml). Префикс выбирается -под файл, а не выводится по формуле, и не переиспользуется никогда. Правила -адресуются идентификатором `KEYS-5` — без пути к файлу. Подробности формы — -`LANGUAGE.md`. +[`prefixes.toml`](prefixes.toml). Префикс выбирается под файл, а не выводится +по формуле, и не переиспользуется никогда. Правила адресуются идентификатором +`KEYS-5` — без пути к файлу. Подробности формы — `LANGUAGE.md`. ## Расширение diff --git a/conventions/prefixes.toml b/prefixes.toml similarity index 77% rename from conventions/prefixes.toml rename to prefixes.toml index be783f5..10112a8 100644 --- a/conventions/prefixes.toml +++ b/prefixes.toml @@ -18,26 +18,29 @@ # изменение, а не переименование; # - тот же префикс продублирован в шапке файла (`prefix:`), conv сверяет. # +# Пути даются от корня репозитория, а не от `conventions/`: реестр покрывает +# и обвязку тоже. +# # Локальные правила репозиториев берут свои префиксы и объявляют их в # `.conventions.toml` копии. Они обязаны не пересекаться с этим реестром. [live] -DIRS = "arch/app-directories.md" -CONF = "arch/config.md" -KEYS = "arch/db-identifiers.md" -TIME = "arch/time.md" -GCFG = "lang/go/config.md" -GKEY = "lang/go/db-identifiers.md" -MIGR = "lang/go/db-schema.md" -GERR = "lang/go/errors.md" -SLOG = "lang/go/logging.md" -GTIM = "lang/go/time.md" -ANSD = "stack/ansible/app-directories.md" -HTMX = "stack/htmx/web-ui.md" +DIRS = "conventions/arch/app-directories.md" +CONF = "conventions/arch/config.md" +KEYS = "conventions/arch/db-identifiers.md" +TIME = "conventions/arch/time.md" +GCFG = "conventions/lang/go/config.md" +GKEY = "conventions/lang/go/db-identifiers.md" +MIGR = "conventions/lang/go/db-schema.md" +GERR = "conventions/lang/go/errors.md" +SLOG = "conventions/lang/go/logging.md" +GTIM = "conventions/lang/go/time.md" +ANSD = "conventions/stack/ansible/app-directories.md" +HTMX = "conventions/stack/htmx/web-ui.md" # Обвязка канона: не синхронизируется в репозитории, но правила # записаны тем же языком и цитируются по номерам, поэтому префикс нужен. -META = "../GUIDE.md" +META = "GUIDE.md" [retired] # Пусто. Сюда попадают префиксы удалённых и разделённых файлов вместе с