name: Test Sphinx Documentation Build

on:
  pull_request:
    branches:
      - "master"
      - "0.2"
    paths:
      - 'docs/**'

jobs:
  docs:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v2

    - name: Set up Python
      uses: ammaraskar/sphinx-action@7.4.7
      with:
        pre-build-command: "python3 -m pip install .[docs]"
        docs-folder: "docs/"

    - name: Build Sphinx documentation
      run: |
        cd docs
        make html SPHINXOPTS="-W"