docs.yml

# =============================================================================
# .github/workflows/docs.yml  —  Manual Documentation Rebuild
# =============================================================================
# Use workflow_dispatch to manually rebuild docs without a release.
# Normal doc deployment happens automatically via release.yml; both delegate
# the actual build to the reusable quarto-build.yml workflow.
# Set deploy=false for a render-only dry run (e.g. to verify doc changes on
# a branch without touching the production gh-pages site).
# =============================================================================

name: Documentation

on:
  workflow_dispatch:
    inputs:
      deploy:
        description: "Publish the rendered site to gh-pages"
        type: boolean
        default: true

permissions: read-all

jobs:
  docs:
    name: Documentation
    uses: ./.github/workflows/quarto-build.yml
    with:
      deploy: ${{ inputs.deploy }}
    permissions:
      contents: write
    secrets: inherit