# Documentation System

## Назначение

Этот файл задает общую модель документации проекта.

## Базовая модель

Каждый документ должен состоять из двух слоев:
- YAML frontmatter
- контент

Контент всегда состоит из двух обязательных разделов:
- `## Summary`
- `## Details`

Над ними должен быть один заголовок `# <title>`, совпадающий со значением `title` во frontmatter.

## Принципы

- Документы должны быть атомарными.
- Один документ описывает одну тему.
- Вместо дублирования между документами используются явные ссылки.
- Связи и навигация должны быть формализованы.
- Документы должны быть пригодны для чтения человеком и для RAG.
- Документы должны быть пригодны для частичного обновления без деградации структуры.

## Типы документов

На уровне проекта поддерживаются типы:
- `api_method`
- `logic_block`
- `architecture_overview`
- `domain_entity`
- `ui_page`
- `integration_doc`
- `index_page`
- `glossary_item`
