Skip to content

docs: drop makedocs warnonly, refresh deps — release 2.2.1-beta - #952

Merged
ocots merged 1 commit into
mainfrom
docs/refresh-manifest-drop-extref-warnonly
Sep 2, 2026
Merged

docs: drop makedocs warnonly, refresh deps — release 2.2.1-beta#952
ocots merged 1 commit into
mainfrom
docs/refresh-manifest-drop-extref-warnonly

Conversation

@ocots

@ocots ocots commented Sep 2, 2026

Copy link
Copy Markdown
Member

Releases 2.2.1-beta — a documentation-infrastructure patch. No change to OptimalControl's
API or runtime behaviour; nothing to migrate.

makedocs warnonly dropped

Both tolerated backlogs are now closed:

category was now
:external_cross_references CTBase.Strategies.parameter(T[, default]) (#944) + 4× Plots.plot(::CTModels.Solutions.Solution) (CTModels' extension docstrings) #944 merged; CTModels fix shipped in 0.19.4-beta (CTModels#428)
:cross_references @ref to DOCPCache (no docstring) CTDirect#630 closed; the docstrings no longer reference it

So makedocs is called with no warnonly — an unresolved @ref / @extref, or a
broken @example / @repl, fails the build.

Verified the way CI resolves (no sibling repos checked out → every objects.inv fetched
remotely): full julia --project=. docs/make.jl, draft = false, all pages execute,
doctests run, 0 unresolved references, exit 0.

Dependencies

  • docs env → CTBase 0.30.4-beta + CTModels 0.19.4-beta; docs/src/assets/Manifest.toml
    regenerated (CTModels 0.19.3 → 0.19.4, SPRAL_jll patch). Project.toml [compat] and
    docs/src/assets/Project.toml unchanged.

Release bookkeeping

  • Project.toml 2.2.0-beta → 2.2.1-beta.
  • CHANGELOG.md: new ## [2.2.1-beta] — 2026-09-02 section, collecting this PR plus the
    already-merged #944
    (_strategy_parameter @extref), #949
    (draft = false default) and #951
    (CI-only remote inventories) — moved out of the still-unreleased 2.2.0-beta section.
  • BREAKING.md: ## Non-breaking notes (2.2.1-beta) — contributor-facing notes only.
  • docs/api-coverage.md: provenance line bumped (symbol set unchanged from 2.2.0-beta).

🤖 Generated with Claude Code

Both cross-reference backlogs are cleared:
- @extref: `_strategy_parameter` (#944) + CTModels' extension docstrings
  (CTModels.jl#428, shipped in CTModels 0.19.4-beta)
- @ref/DOCPCache: CTDirect#630 (closed)

So `makedocs` no longer needs `warnonly` — an unresolved `@ref`/`@extref`, or a
broken `@example`/`@repl`, now fails the build. Verified with the sibling
inventories forced to resolve remotely (as on CI): full build, exit 0, zero
unresolved references.

Also:
- docs env moves to CTBase 0.30.4-beta + CTModels 0.19.4-beta;
  docs/src/assets/Manifest.toml regenerated.
- Project.toml 2.2.0-beta -> 2.2.1-beta (docs-infra patch, no API/runtime
  change); CHANGELOG + BREAKING get a 2.2.1-beta section collecting this plus
  the already-merged #944 (extref), #949 (draft=false default) and #951
  (CI-only remote inventories).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@ocots
ocots force-pushed the docs/refresh-manifest-drop-extref-warnonly branch from 0a0d7ff to e8b54b1 Compare September 2, 2026 16:33
@ocots ocots added documentation Improvements or additions to documentation run documentation Trigger the Documentation workflow on this PR labels Sep 2, 2026
@ocots
ocots merged commit 7fa777a into main Sep 2, 2026
15 of 17 checks passed
@ocots
ocots deleted the docs/refresh-manifest-drop-extref-warnonly branch September 2, 2026 16:44
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