Files
buryan-infra/ops/hub/DOCS-INDEX.md
T

58 lines
2.4 KiB
Markdown

# Индекс документации (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. Разделить «живые» документы и «историю спринтов» по папкам.