Deployment

GitHub Pages first

The repository is configured to deploy with GitHub Actions.

The workflow:

  1. checks out the repository
  2. installs Python
  3. installs MkDocs
  4. builds the static site with mkdocs build
  5. deploys the generated site/ directory to GitHub Pages

Cloudflare Pages next

After GitHub Pages is working, Cloudflare Pages can use the same build contract:

  • build command: mkdocs build
  • output directory: site

This keeps the deployment target flexible without changing the content structure.