реестр префиксов перенесён в корень
- реестр покрывает и обвязку тоже (GUIDE.md), поэтому внутри conventions/ он упирался в путь `../GUIDE.md`; теперь пути даются от корня репозитория - README дополнен разделом про префиксы и строкой в таблице обвязки
This commit is contained in:
@@ -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`.
|
||||
|
||||
## Расширение
|
||||
|
||||
|
||||
Reference in New Issue
Block a user