name: Documentation PRs

on:
  push:
    branches:
      - master
  pull_request:
    branches:
      - master

env:
  DOTNET_CLI_TELEMETRY_OPTOUT: 1
  DOTNET_SKIP_FIRST_TIME_EXPERIENCE: 1
  node_version: 24.x
  NUKE_TELEMETRY_OPTOUT: true

jobs:
  run:
    name: "linting, spell check and build"
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
        name: Check out the code

      - name: Lint Code Base
        uses: docker://ghcr.io/igorshubovych/markdownlint-cli:latest
        with:
          args: "--disable MD009 -- docs/**/*.md"

      - uses: actions/setup-node@v6
        name: Install Node.js
        with:
          node-version: ${{ env.node_version }}

      - run: npm install -g cspell
        name: Install cSpell

      - run: cspell --config ./docs/cSpell.json "docs/**/*.md"
        name: run cSpell

      - name: Install .NET
        uses: actions/setup-dotnet@v3
        with:
          dotnet-version: |
            9.0.x
            10.0.x

      - name: Build docs
        run: ./build.sh docs-build