docs(seo): Wave 7 dual-harness one-liner + Claude/Grok install headings #13
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| # .github/workflows/pages.yml | |
| # Builds the MkDocs site and deploys it to GitHub Pages on every docs change. | |
| # NOTE: the repo's Pages site must be enabled ONCE out-of-band (the Actions token | |
| # cannot create it): | |
| # gh api -X POST repos/OWNER/REPO/pages -f build_type=workflow | |
| name: Pages | |
| on: | |
| workflow_dispatch: | |
| push: | |
| branches: | |
| - main | |
| paths: | |
| - "README.md" | |
| - "docs/**" | |
| - "mkdocs.yml" | |
| - ".github/workflows/pages.yml" | |
| permissions: | |
| contents: read | |
| pages: write | |
| id-token: write | |
| concurrency: | |
| group: pages | |
| cancel-in-progress: true | |
| jobs: | |
| build: | |
| runs-on: ${{ vars.RUNNER || 'ubuntu-latest' }} | |
| steps: | |
| - name: Check out repository | |
| uses: actions/checkout@v7.0.0 | |
| - name: Install Python | |
| uses: actions/setup-python@v6.3.0 | |
| with: | |
| python-version: "3.13" | |
| - name: Configure Pages | |
| uses: actions/configure-pages@v6.0.0 | |
| with: | |
| enablement: true # no-op once the site exists; see header note | |
| - name: Build site | |
| shell: bash | |
| run: | | |
| set -euo pipefail | |
| python -m pip install --upgrade pip mkdocs mkdocs-material | |
| mkdocs build --strict --site-dir site | |
| - name: Upload Pages artifact | |
| uses: actions/upload-pages-artifact@v5.0.0 | |
| with: | |
| path: site | |
| deploy: | |
| needs: build | |
| runs-on: ${{ vars.RUNNER || 'ubuntu-latest' }} | |
| environment: | |
| name: github-pages | |
| url: ${{ steps.deployment.outputs.page_url }} | |
| steps: | |
| - name: Deploy to GitHub Pages | |
| id: deployment | |
| uses: actions/deploy-pages@v5.0.0 |