docs-build.yml

name: Build Docs
on:
  push:
    paths:
      - docs/**
    branches:
      - main
  pull_request:
    branches: '*'
permissions:
  contents: write
jobs:
  docs-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.8"
      - uses: snok/install-poetry@v1
        with:
          version: 1.8.0
          virtualenvs-create: true
          virtualenvs-in-project: true
          installer-parallel: true
      - name: Load cached venv
        id: cached-poetry-dependencies
        uses: actions/cache@v4
        with:
          path: .venv
          key: venv-doc-${{ runner.os }}-${{ steps.setup-python.outputs.python-version }}-${{ hashFiles('**/docs/poetry.lock') }}
      - name: Install Dependencies
        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
        run: |
          cd docs
          poetry install --no-interaction
      - name: Build
        run: |
          cd docs
          poetry run mkdocs build