Skip to content

Fail build/publish on build warnings - #415

Merged
nusbaume merged 12 commits into
NCAR:mainfrom
samsrabin:test-build-on-pr
Oct 15, 2026
Merged

nusbaume merged 12 commits into
NCAR:mainfrom
samsrabin:test-build-on-pr

Conversation

@samsrabin

@samsrabin samsrabin commented Oct 15, 2026 •

Copy link
Copy Markdown
Member

This PR changes the build-and-publish GitHub Workflow to fail when warnings are generated, the idea being to catch important things like if you mistyped a notebook name in _toc.yml. It unfortunately also sweeps up some things that I'd consider unimportant, like skipping straight from heading level 1 to 3. As such, this PR also includes fixes to all such warnings. It also includes fixes related to Jupyter Notebook cell IDs, which wouldn't trigger an error but do clog up the log.

To avoid unpleasant surprises upon PR merges, this PR also adds a trigger so that a build (not publish) is triggered on PRs.

AI usage: I copied the first few commits' worth of changes from work I did in the CLM-Tutorial repo. I then used Claude to fix all the warnings (and commit the fixes, including writing commit text), confirming myself that they're gone. I wrote this PR text myself.

samsrabin and others added 12 commits October 15, 2026 09:45
This is required to catch things that matter (like if you specify something in _toc.yml but it doesn't exist), but unfortunately it also catches things that don't (like skipping from heading level 1 to 3 without a 2 in between).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@samsrabin
samsrabin marked this pull request as ready for review October 15, 2026 16:50
@samsrabin

Copy link
Copy Markdown
Member Author

Mentioning @nusbaume as requested. Thanks!

@nusbaume
nusbaume self-requested a review October 15, 2026 21:48

@nusbaume nusbaume left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thanks @samsrabin!

@nusbaume
nusbaume merged commit 6e17d8b into NCAR:main Oct 15, 2026
1 check passed
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