av
bf6a173115
- DECISIONS.md (4040 строк, 65 тем) → decisions/, файл на тему плюс указатель; - буквенные метки решений заменены сквозными Р1–Р234, следствия получили префикс С при прежних номерах: схема букв выродилась до пятибуквенных и сломалась — `АЕАКЛ` была занята и темой 53, и темой 65; - 42 перекрёстные ссылки переписаны под новые номера и стали живыми; где номер означал тему, а слово стояло «решение», формулировка исправлена.
32 lines
2.6 KiB
Markdown
32 lines
2.6 KiB
Markdown
# 13. Секции `PLAN.md` переименованы (2026-08-03)
|
|
|
|
## Что было
|
|
|
|
Секции назывались **«линия»** и **«кусты»** — метафора, требующая расшифровки
|
|
при каждом употреблении. В текстах она и расшифровывалась: «звено упорядоченной
|
|
линии продукта», «тематический куст — цель, в последовательность не встающая».
|
|
Если название приходится объяснять рядом с каждым употреблением, объясняет не
|
|
название.
|
|
|
|
## Решено
|
|
|
|
**Р45. «порядок» и «темы».** Заголовок называет ровно то свойство, которым
|
|
секции различаются: в первой очередь значима и обоснована прозой, во второй
|
|
порядка нет вовсе. Расшифровывать нечего — правило написано в самом имени.
|
|
|
|
**Р46. Записи в журнал версий канона не требуется — канон этих имён не знает.**
|
|
`canon.md` называет файл `docs/tasks/PLAN.md` и ничего не говорит о его секциях:
|
|
их дом — заголовки `##` индекса, а умолчание живёт в `tasks.py`. Версия канона
|
|
поэтому не меняется, и проект вправе называть секции по-своему. Причина названа
|
|
вслух, потому что соблазн повысить версию «на всякий случай» здесь сильный, а
|
|
повышение обязало бы каждый проект что-то делать — при том что делать нечего.
|
|
|
|
## Что из этого следует
|
|
|
|
**С54. Умолчание одно и живёт в `DEFAULT_PLAN_SECTIONS`.** Имена секций
|
|
по-прежнему настраиваются `--plan-sections`, а домом остаются заголовки `##`
|
|
индекса — переименование не трогает механику, только умолчание и тексты.
|
|
|
|
**С55. Метафора — плохое имя для секции индекса.** Секция читается человеком без
|
|
контекста, часто из вывода `list`, и второго шанса объяснить себя у неё нет.
|