Documentation #409
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
--- | |
name: Documentation | |
"on": | |
schedule: | |
- cron: "0 0 * * 0" # every week at midnight | |
push: | |
paths: | |
- "**.md" | |
- "docs/**" | |
- ".github/workflows/documentation.yml" | |
pull_request: | |
paths: | |
- "**.md" | |
- "docs/**" | |
- ".github/workflows/documentation.yml" | |
jobs: | |
docs: | |
name: Build documentation & check links | |
runs-on: ubuntu-latest | |
steps: | |
- uses: actions/checkout@v3 | |
- uses: actions/setup-python@v5 | |
with: | |
python-version: "3.12" | |
- name: Upgrade pip | |
run: | | |
pip install --constraint=.github/workflows/constraints.txt pip | |
pip --version | |
- name: Install Poetry | |
run: | | |
pipx install --pip-args=--constraint=.github/workflows/python-constraints.txt poetry | |
poetry --version | |
- name: Install Nox | |
run: | | |
pipx install --pip-args=--constraint=.github/workflows/constraints.txt nox | |
pipx inject --pip-args=--constraint=.github/workflows/constraints.txt nox nox-poetry | |
nox --version | |
- name: Build documentation | |
run: nox --force-color --session=docs-build | |
- name: Upload documentation | |
uses: actions/upload-artifact@v3 | |
with: | |
name: docs | |
path: docs/_build |