Skip to content

docs: convert ordered lists to bullets across src/ and docs/src/ - #421

Merged
ocots merged 1 commit into
mainfrom
docs/ordered-lists-sweep
Sep 1, 2026
Merged

ocots merged 1 commit into
mainfrom
docs/ordered-lists-sweep

Conversation

@ocots

@ocots ocots commented Sep 1, 2026

Copy link
Copy Markdown
Member

What

DocumenterVitepress mis-renders ordered lists — valid 1. 2. 3. comes out as <ol start="3">, the first item absorbed as unstyled prose. LuxDL/DocumenterVitepress.jl#150, open, no fix.

Marker-only change (1. → - ), no prose edits.

src/ — 2 files

Solutions/build_solution.jl (2 trajectory-data-format items, each with a nested sub-list — outer marker only changes, nested markers and indentation stay, re-anchored under the new - width) and Building/name_validation.jl (5-point validation check).

docs/src/ — 2 files

getting-started.md and index.md (1 list each, 2 and 4 items) — hand-written prose, never previously swept.

Not build-verified here

This repo's docs build currently fails for an unrelated, pre-existing reason:

Error: failed to run `@example` block in docs/src/serialization/plotting.md:83-85
Makie.plot(sol)
exception = UndefVarError: `MakieBackend` not defined in `CTBase.Plotting`

Nothing to do with ordered lists — confirmed identical on two separate rebuild attempts, before and after this change, so this PR introduces no new failure. Verified instead by source grep (grep -rn '^[0-9]+\. ' src/ docs/src/ → empty) and by the identical fix pattern holding clean, build-confirmed, on the other four repos in this sweep (CTBase, CTSolvers, CTFlows.jl, OptimalControl). The MakieBackend failure is worth its own separate look — not investigated here, out of scope for this change.

Context

Companion PRs open in parallel on OptimalControl, CTBase, CTSolvers and CTFlows.jl. Full plan and inventory: control-toolbox/OptimalControl.jl → .reports/campaign/M-ordered-list-sweep.md.

🤖 Generated with Claude Code

DocumenterVitepress mis-renders ordered lists — valid 1./2./3. source
comes out as <ol start="3">, the first item absorbed as unstyled prose
(LuxDL/DocumenterVitepress.jl#150, open, no fix).

src/Solutions/build_solution.jl (2 trajectory-data-format items, each
with a nested sub-list — outer marker only changes, nested markers
and indentation stay, re-anchored under the new "- " width) and
src/Building/name_validation.jl (5-point validation check).

docs/src/getting-started.md and docs/src/index.md (1 list each, 2 and
4 items) — hand-written prose, never previously swept.

Marker-only change, no prose edits.

Not build-verified here: this repo's docs build currently fails for
an unrelated, pre-existing reason —
`UndefVarError: MakieBackend not defined in CTBase.Plotting` on
docs/src/serialization/plotting.md:83-85 (`Makie.plot(sol)`), nothing
to do with ordered lists. Verified by source grep instead
(`grep -rn '^[0-9]+\. ' src/ docs/src/` -> empty) and by the identical
pattern holding clean, build-confirmed, on the other four repos in
this sweep (CTBase, CTSolvers, CTFlows.jl, OptimalControl).

Companion PRs open in parallel on OptimalControl, CTBase, CTSolvers
and CTFlows.jl. Full plan:
control-toolbox/OptimalControl.jl .reports/campaign/M-ordered-list-sweep.md

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@ocots
ocots merged commit efe4e6a into main Sep 1, 2026
3 checks passed
@ocots
ocots deleted the docs/ordered-lists-sweep branch September 1, 2026 19:52
@ocots ocots mentioned this pull request Sep 2, 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.

1 participant