docs(handbook): скелет путеводителя и README-шапка #210

Merged
ddmitry merged 1 commits from 209-handbook-skeleton into main 2026-09-01 21:30:27 +03:00
Owner

Closes #209

Первый рабочий тикет карты #206: учебная документация стенда.

Что внутри

  • docs/handbook/README.md — вход в путеводитель: тропа чтения
    «словарь → главы → справочники → уроки» и пять аннотированных будущих
    глав с временными ссылками. Файлов-заглушек нет: глава появится файлом
    вместе с текстом.
  • Шапка README.md — переписана для менти: что это и что с этим делать
    (поднять, выключить, разобраться, учиться). Операторские разделы не
    тронуты; в «Документации» добавлены строки про handbook и labs.
  • AGENTS.md — правило имен для docs/handbook/.

Как делалось

Проза — Sol (gpt-5.6-sol) по постановке тикета; ревью постановки — Опус
(1 major внесен); слепое ревью реализации — Опус свежей сессией
(1 minor, 2 nit — исправлены, перепроверено); приёмка — ai-text-lint
плюс оптика литературного русского (одна правка в шапке).

Проверка

Команда проверки ссылок из тикета #209 — пустой вывод; make lint правки
не задевают (только markdown).

Closes #209 Первый рабочий тикет карты #206: учебная документация стенда. ## Что внутри - `docs/handbook/README.md` — вход в путеводитель: тропа чтения «словарь → главы → справочники → уроки» и пять аннотированных будущих глав с временными ссылками. Файлов-заглушек нет: глава появится файлом вместе с текстом. - Шапка `README.md` — переписана для менти: что это и что с этим делать (поднять, выключить, разобраться, учиться). Операторские разделы не тронуты; в «Документации» добавлены строки про handbook и labs. - `AGENTS.md` — правило имен для `docs/handbook/`. ## Как делалось Проза — Sol (gpt-5.6-sol) по постановке тикета; ревью постановки — Опус (1 major внесен); слепое ревью реализации — Опус свежей сессией (1 minor, 2 nit — исправлены, перепроверено); приёмка — ai-text-lint плюс оптика литературного русского (одна правка в шапке). ## Проверка Команда проверки ссылок из тикета #209 — пустой вывод; make lint правки не задевают (только markdown).
ddmitry added 1 commit 2026-09-01 21:16:03 +03:00
- Зачем:
  - менти негде было понять с первого экрана, что перед ним и куда идти;
    тикет #209 карты #206 открывает учебную документацию стенда.
- Что:
  - создан docs/handbook/README.md: тропа чтения и пять аннотированных
    будущих глав с временными ссылками на справочники.
  - шапка README.md переписана для менти: четыре действия и ссылки на
    путеводитель и уроки; в разделе «Документация» добавлены handbook и labs.
  - в AGENTS.md добавлено правило имен для docs/handbook/.
- Проверка:
  - команда проверки ссылок из тикета #209 — пустой вывод;
  - git diff: операторские разделы README не тронуты.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
ddmitry merged commit 2588515b9a into main 2026-09-01 21:30:27 +03:00
ddmitry deleted branch 209-handbook-skeleton 2026-09-01 21:30:27 +03:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ddmitry/clickstream-data-platform#210