av
8739b18a9f
- порядок беклога и роадмапа назначен слоями: проверки, которым можно верить → долги входа → владелец записи и контракт API → конвейер под тестами → приложение и возможности поверх; у каждого движения записана причина; - заведены восемь задач под пункты «Завершения», которых не закрывала ни одна запись, — цель any-audio-source была без задач вовсе; - у четырёх задач сняты критерии, требовавшие того, что делает задача ниже по очереди; исправлены ссылки на несуществующий repo/sqlite и на отменённую разведку об очереди.
3.6 KiB
3.6 KiB
🧹 Переименовать образец конфига в config.example.toml
- Тип: chore
- Категория: Очередь — Поднято наверх: шесть задач ниже правят конфиг и каждая допишет старое имя образца, удлиняя перечень мест переименования.
- Зачем: Конвенция называет config.dist.toml объявленным расхождением, но тут же пишет это имя как правило — документ противоречит сам себе, а образец расходится с конвенцией.
Конвенция конфигурации взята из проекта jellybit и сама называет сегодняшнее
имя расхождением: docs/conventions/config.md, строка 7 — «образец называется
config.dist.toml, а не config.example.toml». Но строки 31 и 34 того же
документа пишут config.dist.toml как правило, с заголовком раздела и всем
прочим. Документ противоречит сам себе, и который из двух читать — не выводится.
Задача закрывает расхождение в пользу конвенции: файл переименовывается, а документ перестаёт спорить сам с собой.
Затрагивает
config.dist.tomlв корне — переименование;docs/conventions/config.md— строка расхождения, заголовок раздела и все упоминания имени;CLAUDE.md, раздел «Команды» — строка про то, что копировать;README.md— командаcpи абзац про недостающий ключ;docs/review.md, «Триггеры метки» — упоминание образца;docs/conventions/README.md— строка про самодокументируемый образец;tasks/items/external-call-timeouts.md,telegram-account-link.md,oidc-login.md— разделы «Затрагивает» ссылаются на имя.
Критерии приёмки
- Имени
config.dist.tomlв репозитории не осталось. Оракул —grep -rn 'config\.dist\.toml' . --exclude-dir=.gitпуст. - Образец лежит под именем
config.example.tomlи по-прежнему не даёт закоммитить реальный конфиг. Оракул —git ls-files config.example.tomlотдаёт файл,git check-ignore config.tomlотдаётconfig.toml. - Конвенция больше не называет имя образца расхождением. Оракул —
grep -n 'config\.example\.toml' docs/conventions/config.mdне находит строки, противопоставляющей одно имя другому (сегодня это строка 7). - Гейт зелёный: битых ссылок правка не оставила. Оракул —
task docs.
Рамки
Состав полей образца и его комментарии не пересматриваются — задача про имя и про ссылки на него. Прорехи образца, помеченные в конвенции строками «Расхождение:», остаются на месте.