docs: deploy via GitHub Pages Actions; serve at docs.roboco.dev

The gh-pages branch deploy (mkdocs gh-deploy --force) raced GitHub's built-in branch deployment and got canceled, and each force-push wiped the custom-domain CNAME. Switch to GitHub's official Pages Actions flow (build -> upload-pages-artifact -> deploy-pages) with a single 'pages' concurrency group, so there is one deterministic deployment and no branch to force-push.

- Set the custom domain to docs.roboco.dev (site_url + a docs/CNAME that ships in the build artifact, so the domain persists across deploys).
- Point the advertised docs URL at https://docs.roboco.dev across README, the usage/deployment stubs, the Makefile help, pyproject, and CLAUDE.md.
- Requires a one-time Settings -> Pages -> Source = "GitHub Actions"; the gh-pages branch is no longer used.
This commit is contained in:
Renn F
2026-06-22 16:02:56 +02:00
parent 2fb63fed1f
commit 8e87506da4
9 changed files with 37 additions and 25 deletions
+1 -1
View File
@@ -493,7 +493,7 @@ help:
@echo " make clean - Clean cache files"
@echo " make prune - Prune docker resources"
@echo ""
@echo "Full docs: https://roboco.dev/docs (preview locally: make serve-docs)"
@echo "Full docs: https://docs.roboco.dev (preview locally: make serve-docs)"
# Python versions list
.PHONY: show-python-versions