av
c2f68e6be1
- именованные регионы `<!-- local:имя -->` заменены на единственный `<!-- conv:local -->`: всё ниже него принадлежит репозиторию, всё выше пересобирается, поэтому имени-которое-можно-осиротить больше нет - лок-файла и `origin_hash` в шапке нет — «что было в прошлый раз» знает git, копии закоммичены, автоматического обновления не существует; транспорт назад (`push`) убран вместе с ними - заведены META-22 (репозиторное пишется ниже маркера) и META-23 (форк не носит `origin:`), META-17 переписан под маркер; буква `X` в префиксе зарезервирована за локальными правилами потребителей
50 lines
3.1 KiB
TOML
50 lines
3.1 KiB
TOML
# Реестр префиксов правил.
|
|
#
|
|
# Префикс — четыре заглавные латинские буквы, уникальные по всему канону.
|
|
# Он выбирается под файл, а не выводится по формуле: префикс нужен, чтобы
|
|
# по нему искать, а не чтобы его разбирать. Поэтому подходящее слово лучше
|
|
# закономерности.
|
|
#
|
|
# Правила реестра:
|
|
#
|
|
# - префикс не переименовывается и не переиспользуется никогда — ссылка
|
|
# из чужого репозитория обязана продолжать указывать на то же место;
|
|
# - при удалении или разделении файла префикс уходит в [retired], а не
|
|
# освобождается;
|
|
# - переезд файла между осями префикс не меняет: идентификатор правила
|
|
# не зависит от таксономии;
|
|
# - вынос части правил в новый файл — это новый префикс и новая
|
|
# нумерация: перенос правила между документами есть смысловое
|
|
# изменение, а не переименование;
|
|
# - тот же префикс продублирован в шапке файла (`prefix:`), conv сверяет.
|
|
#
|
|
# Пути даются от корня репозитория, а не от `conventions/`: реестр покрывает
|
|
# и обвязку тоже.
|
|
#
|
|
# Буква `X` в начале префикса зарезервирована за репозиториями-потребителями:
|
|
# канон её не занимает никогда, локальные правила берут префиксы только на
|
|
# неё (XTIM, XLOG). Согласовывать их с этим реестром не нужно — столкновение
|
|
# невозможно по построению.
|
|
|
|
[live]
|
|
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"
|
|
|
|
[retired]
|
|
# Пусто. Сюда попадают префиксы удалённых и разделённых файлов вместе с
|
|
# причиной и датой, чтобы их нельзя было выдать повторно.
|