Skip to content

Documentation build failures in Buildkite CI #465

@ChrisRackauckas-Claude

Description

@ChrisRackauckas-Claude

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

  1. Path handling issue in make.jl: The script assumes it's run from the root directory, but Buildkite runs it from the docs directory, causing:

    ERROR: LoadError: IOError: open("./docs/Manifest.toml", 0, 0): no such file or directory (ENOENT)
    
  2. 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())) returns nothing when it fails to find a steady state.

  3. Broken external link: The link to https://help.juliahub.com/juliasimcompiler/dev/ returns 404.

  4. 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:

  1. docs/make.jl: Added logic to detect whether run from root or docs directory and adjust paths accordingly
  2. docs/src/tutorials/sispde.md: Added error handling to check if steady state solve was successful
  3. 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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions