Update documentation

Author: Вадим Козыревский

.github/workflows/ci.yaml

@@ -26,6 +26,11 @@ jobs:
           restore-keys: |
             mkdocs-material-
       - run: pip install -r requirements.txt
-      - name: Patch site_url for GitHub Pages
-        run: sed -i 's|https://mkdocs.python-cqrs.dev/|https://vadikko2.github.io/python-cqrs-mkdocs/|g' mkdocs.yml
-      - run: mkdocs gh-deploy --force
+      - name: Build and verify assets
+        run: |
+          mkdocs build --strict
+          ls -la site/
+          test -f site/stylesheets/extra.css || (echo "ERROR: extra.css not in build" && exit 1)
+          test -f site/javascripts/star-link.js || (echo "ERROR: star-link.js not in build" && exit 1)
+      - name: Deploy to GitHub Pages
+        run: mkdocs gh-deploy --force

README.md

@@ -15,3 +15,6 @@ pre-commit install
 ```bash
 mkdocs serve
 ```
+
+## Deployment
+Стили и скрипты подключаются корректно только если в `mkdocs.yml` указан **тот же** `site_url`, что и фактический URL сайта после деплоя. Для GitHub Pages (project site) это `https://<user>.github.io/<repo>/` с завершающим слешем. Если деплой идёт на другой домен или подпуть — измените `site_url` под него, иначе тема будет отдавать неверные пути к CSS/JS и страницы откроются без оформления и анимаций.

mkdocs.yml

@@ -1,5 +1,6 @@
 site_name: python-cqrs
-site_url: https://mkdocs.python-cqrs.dev/
+# Для локальной разработки; при деплое в GitHub Pages CI подставляет правильный site_url
+site_url: https://vadikko2.github.io/python-cqrs-mkdocs/
 site_description: Документация по библиотеке python-cqrs. Паттерны CQRS, Saga, Mediator и Event Driven на Python.
 site_author: Vadim Kozyrevskii
 repo_url: https://github.com/vadikko2/python-cqrs
@@ -126,6 +127,7 @@ plugins:
   - autorefs
 use_directory_urls: true
 strict: true
+docs_dir: docs
 extra_css:
   - stylesheets/extra.css
 extra_javascript: