name: docs

on:
  pull_request:
    branches:
      - master
  push:
    branches:
      - master

jobs:
  test-ubuntu:
    name: "docs on ${{ matrix.python-version }} on ${{ matrix.os }}"
    runs-on: "${{ matrix.os }}"
    strategy:
      matrix:
        python-version: [3.6, 3.7, 3.8]
        os: [ubuntu-latest]
    steps:
    - uses: actions/checkout@v2
    - name: Set up Python ${{ matrix.python-version }}
      uses: actions/setup-python@v1
      with:
        python-version: ${{ matrix.python-version }}
    - name: Install dependencies
      run: |
        sudo apt install -y pandoc
        python -m pip install --upgrade pip
        pip install -r requirements.txt
        pip install -r requirements-jax.txt
        pip install -r requirements-test.txt
        pip install -r docs/requirements.txt
        pip install .
    - name: Test docs
      run: |
        cd docs
        make coverage_check
        make doctest
        make html

name: docs

on:
  pull_request:
    branches:
      - master
  push:
    branches:
      - master

jobs:
  test-ubuntu:
    name: "docs on ${{ matrix.python-version }} on ${{ matrix.os }}"
    runs-on: "${{ matrix.os }}"
    strategy:
      matrix:
        python-version: [3.6, 3.7, 3.8]
        os: [ubuntu-latest]
    steps:
    - uses: actions/checkout@v2
    - name: Set up Python ${{ matrix.python-version }}
      uses: actions/setup-python@v1
      with:
        python-version: ${{ matrix.python-version }}
    - name: Install dependencies
      run: |
        sudo apt install -y pandoc
        python -m pip install --upgrade pip
        pip install -r requirements.txt
        pip install -r requirements-jax.txt
        pip install -r requirements-test.txt
        pip install -r docs/requirements.txt
        pip install .
    - name: Test coverage
      run: |
        cd docs
        make coverage_check
    - name: Test doctests
      run: |
        cd docs
        make doctest
    - name: Test docs to HTML
      run: |
        cd docs
        make html

Break down doc tests into sections.
Break down doc tests into sections.

We can now see clearly that the slowest part of the docs testing is running our
doctests.

PiperOrigin-RevId: 377301313
