58 lines
2.4 KiB
Markdown
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. Разделить «живые» документы и «историю спринтов» по папкам.
|