Skip to content

Conversation

@amotl
Copy link
Member

@amotl amotl commented Dec 23, 2025

About

Improve authoring ergonomics by not invalidating the incremental build cache on errors that happen easily when editing.

References

@amotl amotl requested a review from surister December 23, 2025 20:59
SPHINXBUILD = $(ENV_DIR)/bin/sphinx-build
SPHINXAUTOBUILD = $(ENV_DIR)/bin/sphinx-autobuild
AUTOBUILD_OPTS = --watch $(TOP_DIR) --re-ignore '^(?!.+\.(?:rst|md|mmd|html|css|js|py|conf)$$)' --open-browser --delay 0 --jobs auto
AUTOBUILD_OPTS = --watch $(TOP_DIR) --re-ignore '^(?!.+\.(?:rst|md|mmd|html|css|js|py|conf)$$)' --open-browser --delay 0
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is just a little fix where --jobs auto was defined redundantly: It is already defined per SPHINX_OPTS.

Comment on lines -56 to +57
SPHINX_OPTS = -W -n --jobs auto
SPHINX_OPTS_CI = --keep-going
SPHINX_OPTS = -n --jobs auto
SPHINX_OPTS_CI = -W --keep-going
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This effectively switches the -W option to SPHINX_OPTS_CI, so it is no longer used in authoring mode.

@amotl
Copy link
Member Author

amotl commented Dec 23, 2025

I've validated the patch by bumping downstream cratedb-guide's build.json to use the branch treat-warnings-as-errors-only-on-ci.

@amotl amotl force-pushed the treat-warnings-as-errors-only-on-ci branch from 4252e10 to 956185a Compare December 23, 2025 22:16
@amotl amotl merged commit 43ad99a into main Dec 23, 2025
2 of 3 checks passed
@amotl amotl deleted the treat-warnings-as-errors-only-on-ci branch December 23, 2025 22:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants