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