docs.yaml

name: Documentation
on:
  push:
    branches:
      - "main"
      - "feature/*"
      - "hotfix/*"
      - "release/*"
  pull_request:
    paths:
      - "docs/**"
      - "pyproject.toml"
      - ".github/workflows/docs.yaml"

jobs:
  sphinx:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Setup Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      - name: Install prerequisites
        run: |
          sudo apt update
          sudo apt-get install -y libapt-pkg-dev
          pip install tox
      - name: Lint documentation
        run: tox run -e lint-docs
      - name: Build documentation
        run: tox run -e build-docs
      - name: Upload documentation
        uses: actions/upload-artifact@v4
        with:
          name: docs
          path: docs/_build/