docs-conda.yml

name: Build Docs (Conda)

# We don't want pushes (or PRs) to gh-pages to kick anything off
on:
  pull_request:
    branches:
      - main
      - '[0-9]+.[0-9]+.x'

concurrency:
  group: ${{ github.workflow}}-${{ github.head_ref }}
  cancel-in-progress: true

jobs:
  Docs:
    name: ${{ matrix.os }} ${{ matrix.python-version }}
    runs-on: ${{ matrix.os }}-latest
    defaults:
      run:
        shell: bash -l {0}
    strategy:
      fail-fast: false
      matrix:
        include:
          - python-version: 3.9
            os: Windows
          - python-version: '3.10'
            os: Windows
          - python-version: 3.11
            os: macOS

    steps:
    # We check out only a limited depth and then pull tags to save time
    - name: Checkout source
      uses: actions/checkout@v3
      with:
        fetch-depth: 100

    - name: Get tags
      run: git fetch --depth=1 origin +refs/tags/*:refs/tags/*

    - name: Install from Conda
      uses: ./.github/actions/install-conda
      with:
        type: 'doc'
        python-version: ${{ matrix.python-version }}

    - name: Build docs
      uses: ./.github/actions/build-docs
      with:
        key: ${{ matrix.os }}-${{ matrix.python-version }}