ci-docs.yml

name: CI (docs)

on:
  pull_request:
    paths:
      - ".github/workflows/ci-docs.yml"
      - ".github/workflows/docs-pages.yml"
      - "docs/**"
      - "CHANGELOG.md"
  push:
    branches:
      - main
    paths:
      - ".github/workflows/ci-docs.yml"
      - ".github/workflows/docs-pages.yml"
      - "docs/**"
      - "CHANGELOG.md"


env:
  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # pinned from v6.0.2

      - name: Set up Node.js
        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # pinned from v6.4.0
        with:
          node-version: "24"

      - name: Cache docs node_modules
        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # pinned from v5.0.5
        with:
          path: docs/node_modules
          key: ${{ runner.os }}-docs-node-modules-${{ hashFiles('docs/package.json') }}
          restore-keys: |
            ${{ runner.os }}-docs-node-modules-

      - name: Install docs dependencies
        working-directory: docs
        run: npm install --no-package-lock

      - name: Build docs
        working-directory: docs
        run: npm run build