docs.yml

name: Build docs

on:
  push:
    branches:
        - main
  pull_request:
    branches:
        - main
    types: [opened, synchronize, reopened, ready_for_review]
  workflow_dispatch:

jobs:
  build-docs:
    if: github.event.pull_request.draft == false || github.event_name != 'pull_request'
    permissions:
        contents: write
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository 🛎️
        uses: actions/checkout@v5
      - name: Set up Python 🐍
        uses: actions/setup-python@v6

        with:
          python-version: 3.13
      - name: Install docs dependency group 🛠️
        run: |
          python -m pip install --upgrade pip
          pip install .
          pip install --group docs
      - name: Build docs 📖
        run: mkdocs build
      - name: Deploy docs 🚀
        if: ${{ github.event_name == 'push' }}
        uses: JamesIves/github-pages-deploy-action@v4
        with:
          folder: site