name: Docs

on:
  push:
    branches:
      - main
  pull_request:
    types:
      - opened
      - synchronize

# A new push supersedes the run still queued for the commit before it. Without
# this each commit leaves its own run in the queue and a runner that was offline
# for a while works through a backlog of results nobody will read.
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

jobs:
  docs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          persist-credentials: false
      - name: Install uv
        uses: astral-sh/setup-uv@v7
      # Pinned to the version docker/Dockerfile.docs ships, so the gate matches
      # what docs.fluksio.com actually builds with. --strict fails on warnings
      # (dead internal links, unknown config keys), which is the point of
      # running it here at all — the build itself takes about a second.
      - name: Build the docs site
        run: uvx zensical==0.0.46 build --strict --clean