docs-build-test.yml

name: Test documentation build

on:
  workflow_dispatch:

  push:
    branches:
      - 'docs/**'
      - master

jobs:
  build-documentation:
    runs-on: ubuntu-latest
    strategy:
      max-parallel: 5

    steps:
    - uses: actions/checkout@v4
    - name: Set up Python 3.10
      uses: actions/setup-python@v5
      with:
        python-version: "3.10"
    - name: Add conda to system path
      run: |
        # $CONDA is an environment variable pointing to the root of the miniconda directory
        echo $CONDA/bin >> $GITHUB_PATH
    - name: Install dependencies
      run: |
        conda env update --file environment.yml
    - name: Sphinx build
      run: |
        source activate cobramod-dev
        conda info
        sphinx-build docs/source docs/build