summaryrefslogtreecommitdiff
path: root/.github
diff options
context:
space:
mode:
authorNatalia <124304+nessita@users.noreply.github.com>2026-02-27 11:19:20 -0300
committernessita <124304+nessita@users.noreply.github.com>2026-03-02 15:05:31 -0300
commit3f21cb06e76044ad753055700395e54a1fc4f1e9 (patch)
tree780bdebe9255f347b26be5c9e1af875fc561ef26 /.github
parentffa1dad378927396a5593cd9865c3f751fa59059 (diff)
Aligned docs checks between GitHub Actions and local development.
Diffstat (limited to '.github')
-rw-r--r--.github/workflows/docs.yml59
1 files changed, 10 insertions, 49 deletions
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 09ec383a79..04a93af0d7 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -22,7 +22,9 @@ permissions:
jobs:
docs:
runs-on: ubuntu-24.04
- name: spelling
+ defaults:
+ run:
+ working-directory: docs
timeout-minutes: 60
steps:
- name: Checkout
@@ -37,51 +39,10 @@ jobs:
cache-dependency-path: 'docs/requirements.txt'
- name: Install system spell checker
run: sudo apt update && sudo apt install -y aspell aspell-en
- - run: python -m pip install -r docs/requirements.txt
- - name: Build docs
- run: |
- cd docs
- sphinx-build -b spelling -n -q -W -d _build/doctrees -D language=en_US -j auto . _build/spelling
-
- blacken-docs:
- runs-on: ubuntu-latest
- name: blacken-docs
- timeout-minutes: 60
- steps:
- - name: Checkout
- uses: actions/checkout@v6
- with:
- persist-credentials: false
- - name: Set up Python
- uses: actions/setup-python@v6
- with:
- python-version: '3.14'
- - run: python -m pip install blacken-docs
- - name: Build docs
- run: |
- cd docs
- make black
- RESULT=`cat _build/black/output.txt`
- if [ "$RESULT" -gt 0 ]; then
- echo "💥 📢 Code blocks in documentation must be reformatted with blacken-docs 📢 💥"
- fi;
- exit $RESULT
-
- lint-docs:
- runs-on: ubuntu-latest
- name: lint-docs
- timeout-minutes: 60
- steps:
- - name: Checkout
- uses: actions/checkout@v6
- with:
- persist-credentials: false
- - name: Set up Python
- uses: actions/setup-python@v6
- with:
- python-version: '3.14'
- - run: python -m pip install sphinx-lint
- - name: Build docs
- run: |
- cd docs
- make lint
+ - run: python -m pip install -r requirements.txt
+ - name: Lint
+ run: make lint
+ - name: Black
+ run: make black
+ - name: Spelling
+ run: SPHINXOPTS="-q -W" make spelling