Tooling scaffolding refresh: Dependabot, linkcheck, action-pin bumps - #26
Merged
Merged
Conversation
Mechanical items from the lecture-dp tooling review (tracking: #22): - Add .github/dependabot.yml (github-actions + conda weekly, with the jupyter-book >=2.0 ignore — jb 2.x is the MyST-MD rewrite and not a drop-in upgrade) - Add linkcheck.yml (weekly lychee run against the live site; this repo deploys Pages via the OIDC artifact workflow, so there is no gh-pages branch to check out — the site is mirrored with wget instead) - Bump actions/checkout v4 -> v6, upload-artifact v4 -> v7, download-artifact v4 -> v6 (Dependabot keeps these current from here) - cache.yml: rebuild the build cache when environment.yml changes on main (previously stale for up to a week after env changes) - environment.yml: bump sphinx-proof 0.3.0 -> 0.4.0, sphinxcontrib-youtube 1.4.1 -> 1.5.0, sphinx-togglebutton 0.3.2 -> 0.4.5 (matches the versions the sibling lecture repos run with the same jupyter-book pin) - Remove the placeholder google_analytics_id (G-XXXXXXXXXX); re-add with a real GA4 measurement ID if analytics are wanted The quantecon-book-theme pin (==0.15.1) is deliberately NOT bumped here — that needs a visual layout review and is tracked in #23. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
This PR refreshes repository automation/scaffolding to reduce drift and add maintenance checks, aligning lecture-dp with other lecture repos’ tooling (Dependabot updates, scheduled link checking, and workflow pin/cache maintenance).
Changes:
- Add Dependabot configuration for GitHub Actions and conda (
environment.yml) updates, with an explicit ignore forjupyter-book>=2.0. - Add a scheduled/manual link-check workflow using
lycheeagainst a mirrored copy of the published site. - Refresh CI/publish/cache workflows (action major bumps; rebuild cache when
environment.ymlchanges) and update a few pinned Sphinx extension versions; remove the placeholder GA4 ID.
Reviewed changes
Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
lectures/_config.yml |
Removes non-functional Google Analytics placeholder configuration. |
environment.yml |
Updates pinned Sphinx extension versions used by the build. |
.github/workflows/publish.yml |
Updates workflow action pins used for checkout/artifact handling during publish. |
.github/workflows/linkcheck.yml |
Introduces scheduled/manual link checking against the live published site. |
.github/workflows/ci.yml |
Updates workflow action pins used for checkout/artifact handling during PR CI. |
.github/workflows/cache.yml |
Triggers cache rebuilds on environment.yml changes and updates checkout action pin. |
.github/dependabot.yml |
Adds Dependabot updates for GitHub Actions and conda, with jupyter-book>=2.0 ignored. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
This was referenced Jun 21, 2026
Previously `wget ... || true` let the job report success even when the mirror failed, so lychee ran against an empty directory and reported no broken links (false negative, per Copilot review on #26). Now count the mirrored HTML files: if zero, skip lychee and open an issue noting the mirror failed; otherwise run lychee as before. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
4 tasks
The Build Cache workflow passed `builder:` (singular), but the quantecon/actions/build-jupyter-cache input is `builders` (plural), so the value was silently ignored. It was harmless only because the action default is already `html`; renaming makes the intent explicit and avoids a silent no-op if the builder set ever changes. Refs #31 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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
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.
Part of #22 — the mechanical "Bucket A" items that need no maintainer decisions.
What's in here
.github/dependabot.yml(github-actions + conda, weekly, with thejupyter-book >=2.0ignore)lecture-python-advanced.mystthe exact sphinx-extension bumps this repo missed. Without it this repo drifts silently.linkcheck.yml(weekly lychee run)gh-pagesbranch — the workflow mirrors the live site (dp.quantecon.org) with wget instead of the checkout-gh-pages pattern other lecture repos use.actions/checkoutv4→v6,upload-artifactv4→v7,download-artifactv4→v6cache.yml: rebuild onenvironment.ymlchange (push to main)environment.yml:sphinx-proof0.3.0→0.4.0,sphinxcontrib-youtube1.4.1→1.5.0,sphinx-togglebutton0.3.2→0.4.5jupyter-bookpin.google_analytics_id: G-XXXXXXXXXXDeliberately NOT in here
quantecon-book-theme==0.15.1is untouched — 0.21.0 ships a layout overhaul and needs a visual review; tracked in Bump quantecon-book-theme 0.15.1 → 0.21 (layout review needed) #23.quantecon/actions/*@v0.6.0pins — unchanged pending a QuantEcon/actions v1.0 release (tracked in Tooling: bring lecture-dp up to lecture-repo standards (tracking) #22).Validation
linkcheck.ymlis schedule +workflow_dispatch; it can be smoke-tested from the Actions tab after merge.🤖 Generated with Claude Code