docs-build.yml

name: docs build

on:
  pull_request:
    paths:
      - 'docs/**'
      - '.github/workflows/docs-build.yml'
  workflow_dispatch:

jobs:
  docs-build:
    runs-on: ubuntu-latest
    defaults:
      run:
        working-directory: docs
    steps:
      - name: Check out
        uses: actions/checkout@v4

      - name: Set up Node
        uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: yarn
          cache-dependency-path: |
            yarn.lock
            docs/yarn.lock

      - name: Install library dependencies (local source)
        working-directory: ${{ github.workspace }}
        run: yarn install --immutable

      - name: Install dependencies
        run: yarn install --immutable

      - name: Typecheck docs
        working-directory: ${{ github.workspace }}
        run: yarn typecheck:docs

      - name: Build docs
        run: yarn build