журнал решений: разложен по теме на файл, метки решений стали номерами

- DECISIONS.md (4040 строк, 65 тем) → decisions/, файл на тему плюс указатель;
- буквенные метки решений заменены сквозными Р1–Р234, следствия получили
  префикс С при прежних номерах: схема букв выродилась до пятибуквенных и
  сломалась — `АЕАКЛ` была занята и темой 53, и темой 65;
- 42 перекрёстные ссылки переписаны под новые номера и стали живыми; где номер
  означал тему, а слово стояло «решение», формулировка исправлена.
This commit is contained in:
av
2026-08-13 12:40:56 +03:00
parent b411d4edb8
commit bf6a173115
72 changed files with 4253 additions and 4053 deletions
@@ -0,0 +1,56 @@
# 25. Секция `Сопровождение` и общий словарь трёх мест (2026-08-04)
## Что было
`Разработка` — имя, которое называло слишком много: роадмап **весь** про
разработку, и секция с таким именем не отличалась от остальных ничем. Предложено
`Сопровождение` (англ. `Operations`).
## Решено
**Р101. Секция называется `Сопровождение` / `Operations`, и её смысл расширен.**
Было «инструмент и процесс», стало «чем держат проект: инструмент, процесс,
эксплуатация». Расширение не косметическое: английское `Operations` при узком
смысле обещало бы эксплуатацию, а внутри лежал бы линтер. Либо слово, либо смысл
— сошлись на смысле, потому что метрики, логи, инфраструктура и выкладка в эту
секцию просятся и так.
**Р102. Версия канона не менялась, и это законно.** ~~Ни один проект на каноне 3
не стоит: healthlog и jellybit держат канон 2, повышение только предстоит.~~
**Отменено в тот же день ([тема
26](26-canon-4-retroactive-edit-cancelled.md)).** Посылка была ложной: healthlog
уже переехал на канон 3, и правка записи версии 3 задним числом переписывала то,
по чему он ехал. Правило осталось верным, применение — нет: черновиком запись
версии является ровно до того, как **первый** проект по ней поехал.
**Р103. Сопровождение и эксплуатация — целое и часть, и словарь у трёх мест
общий.** Тема живёт в трёх документах, и раньше каждое место говорило своим
словом. Теперь: сопровождение — всё, чем держат проект (инструмент, процесс,
выкладка, метрики, логи, инфраструктура, дежурство); эксплуатация — его часть,
работа системы на проде.
| Место | Уровень | Что там |
| --- | --- | --- |
| `ROADMAP.md`, секция `Сопровождение` | план | работы, которые собираемся делать |
| `architecture.md`, раздел «Эксплуатация» | состояние | как устроено сейчас |
| эксплуатационный проход ревью | оптика | «это упало через неделю на проде» |
**Сливать три места в одно слово было бы ошибкой**: они отвечают на разные
вопросы — план, состояние, проверка. Синхронизирован **словарь**, а не границы;
дом словаря — `canon.md`.
Слово **«поддержка» запрещено вовсе**: в нём слышится помощь пользователю, а это
третья работа, к этим двум не относящаяся.
## Что из этого следует
**С96. Граница с возможностями проходит по тому, кто наблюдает.** «Приложение
сообщает о своём состоянии» — возможность (наблюдает пользователь сервиса);
«дежурный видит состояние на одном экране» — сопровождение (наблюдаем мы). Одни
и те же метрики попадают в разные секции роадмапа, и это верно.
**С97. `check --fix` чужую секцию не переименовывает — и правильно.** На
переименовании `Разработка``Сопровождение` проверка назвала секцию роадмапа
чужой и остановилась: регистр она правит сама, смысл — нет. Ровно то поведение,
которое нужно проекту при повышении канона.