Skip to content

docs: drop the truncated-Available note on gpu.md (CTBase#557 fixed) - #945

Merged
ocots merged 1 commit into
mainfrom
docs/gpu-note-553
Sep 2, 2026
Merged

docs: drop the truncated-Available note on gpu.md (CTBase#557 fixed)#945
ocots merged 1 commit into
mainfrom
docs/gpu-note-553

Conversation

@ocots

@ocots ocots commented Sep 2, 2026

Copy link
Copy Markdown
Member

Small follow-up to #941. That PR shipped gpu.md's AmbiguousDescription diagnostic with a note explaining Available was truncated at 10 entries with no marker, silently dropping the two :gpu methods it exists to show — a bug filed as CTBase#553.

CTBase's own fix (0.30.3-beta) turned out to swap the problem rather than solve it: Available started showing 5 of 12 methods (the closest matches) with nothing saying so, and the Hint line ended on a colon with nothing after it. Filed as CTBase#557, fixed in CTBase#558, released as CTBase 0.30.4-beta — both same day.

This PR bumps the docs environment to 0.30.4-beta and drops the note. Verified on the actual rebuilt page, not just the fix in isolation — solve(ocp, :adnlp, :gpu) now renders:

julia> solve(ocp, :adnlp, :gpu)
AmbiguousDescription → _complete_description, strategy_builders.jl:260
│
│  Diagnostic  No complete match — no description contains all symbols
│  Requested   (:adnlp, :gpu)
│  Available   (:collocation, :adnlp, :ipopt, :cpu)
│              … all 12, GPU entries included …
│              (:collocation, :exa, :madnlp, :gpu)
│              (:collocation, :exa, :madncl, :gpu)
│
│  Context     description completion
│  Hint        Try one of the closest matches:
└─

docs/Project.toml's CTBase = "0.30" already covers 0.30.4-beta, so no [compat] change — only the tracked docs/src/assets/Manifest.toml snapshot, regenerated by the build.

Verification

Full local build (julia --project=. docs/make.jl), exit 0: 0 Cannot resolve @ref, 6 @extref — the unchanged pre-existing backlog. No new .png.

🤖 Generated with Claude Code

CTBase 0.30.4-beta (control-toolbox/CTBase.jl#558, merged/released
2026-09-02) fixes the follow-up to #553 this page's note was warning
about: `Available` was listing 5 of 12 methods with nothing saying so,
and the `Hint` line ended on a colon with nothing after it. On the
`solve(ocp, :adnlp, :gpu)` case this page demonstrates, `Available` now
lists all 12 methods -- GPU entries included -- and the hint carries its
own list. Verified against the actual rebuilt page, not just the fix in
isolation.

`docs/Project.toml`'s `CTBase = "0.30"` already covers 0.30.4-beta, so no
[compat] change is needed -- only the tracked
`docs/src/assets/Manifest.toml` snapshot, regenerated by this build per
the standing rule.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@ocots ocots added run documentation Trigger the Documentation workflow on this PR documentation Improvements or additions to documentation labels Sep 2, 2026
@ocots
ocots merged commit 7f2c376 into main Sep 2, 2026
13 checks passed
@ocots
ocots deleted the docs/gpu-note-553 branch September 2, 2026 13:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation run documentation Trigger the Documentation workflow on this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant