kernel-builder-cli-docs.yaml

name: Check CLI docs are up to date

on:
  pull_request:
    paths:
      - "kernel-builder/src/**"
      - "kernel-builder/Cargo.toml"
      - "docs/source/builder-cli.md"
      - "Makefile"
      - ".github/workflows/kernel-builder-cli-docs.yaml"
  push:
    branches:
      - main

jobs:
  check-cli-docs:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2

      - name: Install Rust toolchain
        uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8  # stable

      - name: Cache cargo registry and build
        uses: actions/cache@a7833574556fa59680c1b7cb190c1735db73ebf0  # v5.0.0
        with:
          path: |
            ~/.cargo/registry
            ~/.cargo/git
            target
          key: ${{ runner.os }}-cargo-cli-docs-${{ hashFiles('**/Cargo.lock') }}
          restore-keys: |
            ${{ runner.os }}-cargo-cli-docs-

      - name: Generate CLI docs
        run: make kernel-builder-cli-docs

      - name: Check docs are up to date
        run: |
          if ! git diff --quiet docs/source/builder-cli.md; then
            echo "::error::builder-cli.md is out of date. Run 'make kernel-builder-cli-docs' to regenerate."
            git diff docs/source/builder-cli.md
            exit 1
          fi
          echo "CLI docs are up to date."