2.4 KiB
2.4 KiB
Индекс документации (10.11.2026)
Проблема
630 markdown-файлов в ops/ и 946 по репозиторию. Индекс docs/README.md
описывал 6 документов. Найти нужное можно было только grep'ом.
Документация — сильная сторона проекта (фиксирует ловушки), но без навигации она превращается в архив.
Что сделано
ops/scripts/build_docs_index.py
Собирает все .md из ops/, берёт заголовок, размер и дату изменения,
группирует по каталогам. Пишет ops/INDEX.md.
файлов: 630
каталогов: 95
размер индекса: 76 КБ
Свежие файлы — сверху, у каждого каталога счётчик «за неделю»:
## ops — 45 файлов (29 за неделю)
| Документ | О чём | Изменён |
|---|---|---|
| AUDIT-LOCAL-RENDER-2026-11-09.md | Локальные рендеры комнат | 09.11 |
| SERVICE-STANDARD.md | Единый стандарт сервиса | 07.11 |
| NOTIFICATIONS.md | Политика уведомлений (анти-спам) | 06.11 |
Автообновление
Задание Hermes docs-index ежедневно в 06:50. Индекс не устареет.
Индекс попадает в RAG
ops/INDEX.md лежит в индексируемом каталоге — значит секретарь сможет
найти документ по описанию, а не только по содержимому.
Итог
| Было | Стало |
|---|---|
| 630 файлов без навигации | индекс по каталогам с описаниями |
ручной grep |
таблица «документ — о чём — когда» |
docs/README.md (6 ссылок) |
ops/INDEX.md (630 файлов) |
Осталось
docs/README.md— обновить, чтобы вело наops/INDEX.md.- Часть документов старше месяца — кандидаты на архивацию (44 файла).
- Разделить «живые» документы и «историю спринтов» по папкам.