Skip to content

Commit c70ce50

Browse files
committed
ci(docs): Fail the docs build on Sphinx warnings
why: The docs job did not pass -W, so a warning printed and the build still went green. That is not hypothetical: sphinx-autodoc-fastmcp raised diagnostics through a stdlib logger that Sphinx never saw, so a build could report a problem and exit 0. Those diagnostics now go through Sphinx's warning stream, and without -W nothing would act on them. what: Pass -W --keep-going through the existing sphinxopts variable, so the justfile is unchanged and a local `just html` keeps its current behaviour. --keep-going reports every warning in one run rather than stopping at the first. Verified against this branch's current pin: the build passes, and it fails when a warning is present, so the gate can actually bite.
1 parent 7820b1b commit c70ce50

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

‎.github/workflows/docs.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ jobs:
7474
- name: Build documentation
7575
if: env.PUBLISH == 'true'
7676
run: |
77-
cd docs && just html
77+
cd docs && just sphinxopts="-W --keep-going" html
7878
7979
- name: Configure AWS Credentials
8080
if: env.PUBLISH == 'true'

0 commit comments

Comments
 (0)