name: "API Reference"
on:
  pull_request:
    types: [opened, synchronize, edited]

jobs:
  docs:
    if: true == contains(github.event.pull_request.title, 'DOC')
    runs-on: ubuntu-latest
    timeout-minutes: 20
    env:
      OS: ${{ matrix.os }}
      PYTHON: '3.9'
    steps:
    - uses: actions/checkout@master
    - name: Setup Python ${{ matrix.python-version }}
      uses: actions/setup-python@master
      with:
        python-version: ${{ matrix.python-version }}
    - name: Generate Documentation
      uses: ammaraskar/sphinx-action@master
      with:
        docs-folder: "doc/"
    - name: Upload Documentation
      uses: actions/upload-artifact@v3
      with:
        name: APIReference
        path: doc/build/html/