Как обновлять книгу

Книга хранится как набор Markdown-страниц в репозитории. Это дает понятную историю изменений, ревью, откаты и возможность подключить AI-скилл для аккуратных правок.

Базовый процесс

1. Участник предлагает изменение через issue или pull request.
2. Редактор проверяет, где именно меняется смысл: глава, приложение, терминология или структура.
3. Если правка небольшая, ее можно принять напрямую после проверки сборки.
4. Если правка меняет методологию, редактор просит обоснование и при необходимости выносит изменение в отдельный pull request.
5. После принятия изменений сайт пересобирается автоматически.

Роль AI-скилла

AI-скилл обновления книги должен работать с Git, а не менять опубликованный сайт напрямую. Нормальный поток такой:

1. Найти нужные страницы в docs/.
2. Предложить diff с пояснением, почему меняется текст.
3. Проверить редакторские правила и структуру навигации.
4. Создать ветку и pull request.
5. Дождаться человеческого ревью.

Минимальная модель прав

• reader может читать опубликованный сайт.
• contributor может предлагать issue или pull request.
• editor может принимать содержательные правки.
• maintainer может менять структуру сайта, зависимости и настройки публикации.

Для большого коммьюнити не стоит выдавать прямую запись в main. Безопаснее принимать изменения через pull request.