# Реестр префиксов правил. # # Префикс — четыре заглавные латинские буквы, уникальные по всему канону. # Он выбирается под файл, а не выводится по формуле: префикс нужен, чтобы # по нему искать, а не чтобы его разбирать. Поэтому подходящее слово лучше # закономерности. # # Правила реестра: # # - префикс не переименовывается и не переиспользуется никогда — ссылка # из чужого репозитория обязана продолжать указывать на то же место; # - при удалении или разделении файла префикс уходит в [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] # Пусто. Сюда попадают префиксы удалённых и разделённых файлов вместе с # причиной и датой, чтобы их нельзя было выдать повторно.