name: Docs

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

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