- Зачем:
- относительные ссылки на каталоги sql/ и data/ давали 404 на GitHub Pages;
- em-dash в заголовках нарушает правило AGENTS.md (расходятся слаги GitHub/MkDocs);
- 2-пробельная вложенность и списки без пустой строки ломали рендер в MkDocs
- Что:
- ссылки на папки заменены на GitHub-tree-ссылки (работают на обеих платформах);
- в 26 заголовках « — » заменено на «: » или убрано (README, SCD, DataVault, домашка);
- пустая строка перед списком «Главные правила» в DataVault;
- вложенные списки DataVault переведены на 4-пробельный отступ
- Проверка:
- mkdocs build --strict (без ошибок);
- grep по репо — якорных ссылок на старые слаги заголовков нет;
- grep по site/dwh-modeling/*.html — списки рендерятся <ul>/<li>, вложенность сохранена
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- роадмап нуждается в презентабельном виде с навигацией и поиском, а не только GitHub README.
- Что:
- создан mkdocs.yml (Material, docs_dir: ., поиск на русском, тёмная/светлая тема).
- создан .github/workflows/deploy-site.yml (push в main → сборка → GitHub Pages).
- адаптирован Markdown для dual compatibility (GitHub + MkDocs): пустые строки перед списками, отступы 2sp→4sp, заголовки README #→## для корректного TOC.
- заменены em-dash на запятые в 4 заголовках dwh-modeling/README.md (фикс расхождения якорей).
- добавлены правила Markdown Style и команды MkDocs/Playwright в AGENTS.md.
- Проверка:
- uv run --with 'mkdocs-material==9.6.14' --with 'mkdocs-same-dir==0.1.3' mkdocs build --strict
ddadminandClaude Fable 5