Files

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 файлов)

Осталось

  1. docs/README.md — обновить, чтобы вело на ops/INDEX.md.
  2. Часть документов старше месяца — кандидаты на архивацию (44 файла).
  3. Разделить «живые» документы и «историю спринтов» по папкам.