Update documentation

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

.github/workflows/ci.yaml

@@ -26,6 +26,9 @@ 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
       - name: Build and verify assets
         run: |
           mkdocs build --strict

README.md

@@ -17,4 +17,8 @@ mkdocs serve
 ```
 
 ## Deployment
-Стили и скрипты подключаются корректно только если в `mkdocs.yml` указан **тот же** `site_url`, что и фактический URL сайта после деплоя. Для GitHub Pages (project site) это `https://<user>.github.io/<repo>/` с завершающим слешем. Если деплой идёт на другой домен или подпуть — измените `site_url` под него, иначе тема будет отдавать неверные пути к CSS/JS и страницы откроются без оформления и анимаций.
+Стили и скрипты подключаются корректно только если в `mkdocs.yml` указан **тот же** `site_url`, что и фактический URL сайта после деплоя.
+
+- **Timeweb (Docker)** — в репозитории уже задан `site_url: https://mkdocs.python-cqrs.dev/`; сборка через Docker использует его как есть.
+- **GitHub Pages** — в CI перед сборкой подставляется `site_url` для `https://vadikko2.github.io/python-cqrs-mkdocs/`.
+- Другой домен/подпуть — задайте свой `site_url` в `mkdocs.yml` (с завершающим слешем) или подменяйте его при сборке.

mkdocs.yml

@@ -1,6 +1,6 @@
 site_name: python-cqrs
-# Для локальной разработки; при деплое в GitHub Pages CI подставляет правильный site_url
-site_url: https://vadikko2.github.io/python-cqrs-mkdocs/
+# Деплой на Timeweb: https://mkdocs.python-cqrs.dev/ ; для GitHub Pages CI подставляет свой URL
+site_url: https://mkdocs.python-cqrs.dev/
 site_description: Документация по библиотеке python-cqrs. Паттерны CQRS, Saga, Mediator и Event Driven на Python.
 site_author: Vadim Kozyrevskii
 repo_url: https://github.com/vadikko2/python-cqrs