-
-
Notifications
You must be signed in to change notification settings - Fork 39
Description
Problem
The documentation build is failing in Buildkite CI with multiple errors as seen in https://buildkite.com/julialang/methodoflines-dot-jl/builds/407
Root Causes Identified
-
Path handling issue in make.jl: The script assumes it's run from the root directory, but Buildkite runs it from the
docsdirectory, causing:ERROR: LoadError: IOError: open("./docs/Manifest.toml", 0, 0): no such file or directory (ENOENT) -
Example failure in sispde.md: The
episize!function fails with:MethodError: no method matching view(::Nothing, ::UnitRange{Int64})This happens because
solve(steadystateprob, DynamicSS(Tsit5()))returnsnothingwhen it fails to find a steady state. -
Broken external link: The link to https://help.juliahub.com/juliasimcompiler/dev/ returns 404.
-
GitHub rate limiting: Some documentation links to GitHub are hitting rate limits (429 errors) during linkcheck.
Proposed Fixes
I've created a branch with fixes for issues 1-3. The changes:
- docs/make.jl: Added logic to detect whether run from root or docs directory and adjust paths accordingly
- docs/src/tutorials/sispde.md: Added error handling to check if steady state solve was successful
- docs/src/performance.md: Updated broken JuliaHub link
The GitHub rate limiting (issue 4) is transient and should resolve itself, or linkcheck could be disabled for CI builds.
Testing
Tested the fixes locally - documentation now builds successfully from both root and docs directories.
I was unable to create a PR due to authentication issues, but the fixes are ready and tested.
🤖 Generated with Claude Code