Files
dev-skills/decisions/25-maintenance-section-shared-vocab.md
T
av bf6a173115 журнал решений: разложен по теме на файл, метки решений стали номерами
- DECISIONS.md (4040 строк, 65 тем) → decisions/, файл на тему плюс указатель;
- буквенные метки решений заменены сквозными Р1–Р234, следствия получили
  префикс С при прежних номерах: схема букв выродилась до пятибуквенных и
  сломалась — `АЕАКЛ` была занята и темой 53, и темой 65;
- 42 перекрёстные ссылки переписаны под новые номера и стали живыми; где номер
  означал тему, а слово стояло «решение», формулировка исправлена.
2026-08-13 12:40:56 +03:00

57 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` чужую секцию не переименовывает — и правильно.** На
переименовании `Разработка``Сопровождение` проверка назвала секцию роадмапа
чужой и остановилась: регистр она правит сама, смысл — нет. Ровно то поведение,
которое нужно проекту при повышении канона.