fix: repair documentation configs and figure captions - #42
Merged
Conversation
koen-vg
changed the title
…figs The doc_figures config pinned water.data.availability to current_use, which contradicts the gbd-anchored calibration artefacts it consumes, so the provenance check aborted every documentation build. Drop the pin and use the default AWARE water supply. The regional water availability figure was the last consumer of the growing-season column that only the current_use branch writes; it now reports annual renewable availability, which both sources provide, and no longer credits the volumes to the Water Footprint Network. The validation and tutorial configs enabled health, which forced a manual IHME GBD download on anyone running them and anchored their baseline diet to GBD intake exposure. No validation figure or tutorial notebook reads health output, and validation.rst and tutorial.rst both already stated health was off. Turn it off in all four, leaving doc_figures as the single config that needs the manual download for its health cluster, burden and marginal-YLL figures. Also drop overrides that only restated default.yaml, fix the doc_figures header claiming a coarser resolution it never set, and sync the affected prose.
koen-vg
force-pushed
the
chore-recalibrate-after-simplifications
branch
from
July 29, 2026 21:16
6bb7d9b to
452da36
Compare
koen-vg
marked this pull request as ready for review
July 29, 2026 21:16
This file contains hidden or 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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR repairs the documentation workflow and synchronizes its prose with the current model:
Validation
pixi run -e dev sphinx-build -b dummy docs /tmp/glade-docs-dummy