Skip to content

docs: fix two dead links breaking linkcheck CI#5575

Merged
rtimms merged 3 commits into
pybamm-team:mainfrom
rtimms:fix-docs-linkcheck-deadlinks
Jun 8, 2026
Merged

docs: fix two dead links breaking linkcheck CI#5575
rtimms merged 3 commits into
pybamm-team:mainfrom
rtimms:fix-docs-linkcheck-deadlinks

Conversation

@rtimms

@rtimms rtimms commented Jun 5, 2026

Copy link
Copy Markdown
Contributor

Description

The linkChecker GitHub Action and the Read the Docs build's linkcheck pre_build step are currently failing on main and on every open PR because two hard-coded docs.pybamm.org links 404 after the docs site was reorganised:

Notebook Old (404) New
performance/01-simulation-pipeline.ipynb source/api/simulation.html source/api/simulation/simulation.html
solvers/idaklu-jax-interface.ipynb installation/gnu-linux-mac.html#optional-jaxsolver installation/index.html#optional-jaxsolver

The Simulation API page now lives under source/api/simulation/, and the optional-jaxsolver anchor moved from the (now-removed) gnu-linux-mac install page into installation/index. Both replacement URLs were verified to return 200.

This repoints the two links so docs CI goes green repo-wide. One-line change per notebook; no other content touched.

Type of change

  • Bug fix (non-breaking change which fixes an issue)

🤖 Generated with Claude Code

Two notebook links 404 after the docs site reorganised, failing the
linkChecker job and the Read the Docs linkcheck pre_build step on every
branch:

- source/api/simulation.html -> source/api/simulation/simulation.html
- installation/gnu-linux-mac.html#optional-jaxsolver ->
  installation/index.html#optional-jaxsolver

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@rtimms rtimms requested a review from a team as a code owner June 5, 2026 10:57
@review-notebook-app

Copy link
Copy Markdown

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@codecov

codecov Bot commented Jun 5, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.19%. Comparing base (f5615f5) to head (b53ff95).

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #5575   +/-   ##
=======================================
  Coverage   98.18%   98.19%           
=======================================
  Files         339      339           
  Lines       31637    31637           
=======================================
+ Hits        31064    31065    +1     
+ Misses        573      572    -1     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

valentinsulzer
valentinsulzer previously approved these changes Jun 6, 2026
The site is live but its LiteSpeed anti-bot WAF returns 415 to CI/datacenter
IPs, breaking the link checker even though the link is valid.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
No code changes. Earlier failures (lychee, test-data downloads, RTD
sphinx-linkcheck) were all transient github.com 504 Gateway Timeouts on
live links, not real breakages.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@rtimms rtimms merged commit cf4ae1e into pybamm-team:main Jun 8, 2026
27 checks passed
BradyPlanden pushed a commit that referenced this pull request Jun 16, 2026
* docs: fix dead links breaking linkcheck CI

Two notebook links 404 after the docs site reorganised, failing the
linkChecker job and the Read the Docs linkcheck pre_build step on every
branch:

- source/api/simulation.html -> source/api/simulation/simulation.html
- installation/gnu-linux-mac.html#optional-jaxsolver ->
  installation/index.html#optional-jaxsolver

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* fix: ignore bpxstandard.com in lychee (WAF false positive)

The site is live but its LiteSpeed anti-bot WAF returns 415 to CI/datacenter
IPs, breaking the link checker even though the link is valid.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* ci: re-trigger builds (transient GitHub 504s)

No code changes. Earlier failures (lychee, test-data downloads, RTD
sphinx-linkcheck) were all transient github.com 504 Gateway Timeouts on
live links, not real breakages.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
(cherry picked from commit cf4ae1e)
This was referenced Jun 16, 2026
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.

3 participants