av
dcdd92230b
- идентификатор правила теперь `<ПРЕФИКС>-<номер>` вместо `R<номер>`: префикс уникален по всему канону, поэтому ссылка больше не требует пути к файлу и не зависит от того, на какой оси файл лежит - префикс выбирается под файл, а не выводится по формуле, и хранится в conventions/prefixes.toml вместе с выбывшими; номера сохранены один в один вместе с дырами
45 lines
2.6 KiB
TOML
45 lines
2.6 KiB
TOML
# Реестр префиксов правил.
|
|
#
|
|
# Префикс — четыре заглавные латинские буквы, уникальные по всему канону.
|
|
# Он выбирается под файл, а не выводится по формуле: префикс нужен, чтобы
|
|
# по нему искать, а не чтобы его разбирать. Поэтому подходящее слово лучше
|
|
# закономерности.
|
|
#
|
|
# Правила реестра:
|
|
#
|
|
# - префикс не переименовывается и не переиспользуется никогда — ссылка
|
|
# из чужого репозитория обязана продолжать указывать на то же место;
|
|
# - при удалении или разделении файла префикс уходит в [retired], а не
|
|
# освобождается;
|
|
# - переезд файла между осями префикс не меняет: идентификатор правила
|
|
# не зависит от таксономии;
|
|
# - вынос части правил в новый файл — это новый префикс и новая
|
|
# нумерация: перенос правила между документами есть смысловое
|
|
# изменение, а не переименование;
|
|
# - тот же префикс продублирован в шапке файла (`prefix:`), conv сверяет.
|
|
#
|
|
# Локальные правила репозиториев берут свои префиксы и объявляют их в
|
|
# `.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"
|
|
|
|
# Обвязка канона: не синхронизируется в репозитории, но правила
|
|
# записаны тем же языком и цитируются по номерам, поэтому префикс нужен.
|
|
META = "../GUIDE.md"
|
|
|
|
[retired]
|
|
# Пусто. Сюда попадают префиксы удалённых и разделённых файлов вместе с
|
|
# причиной и датой, чтобы их нельзя было выдать повторно.
|