docs.yml

name: Docs

# Build-only check for the docs/ MkDocs source. Strict mode turns broken
# links and nav entries into build failures. This no longer deploys to
# GitHub Pages (ADR-101): asdecided.github.io/core/ is now served by
# the asdecided/asdecided.github.io umbrella site, which vendors docs/ at
# build time. Once that repo's site is live, disable Pages on this repo
# (Settings -> Pages -> Source) so its own project-page deployment stops
# shadowing the umbrella site at that URL.

on:
  push:
    branches: [main]

permissions:
  contents: read

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: actions/setup-python@v6
        with:
          python-version: "3.12"
      - name: Install MkDocs
        run: pip install mkdocs==1.6.1 mkdocs-material==9.7.6
      - name: Build site (strict)
        run: mkdocs build --strict