docs: drop the inverted draft setup (#948) - #949
Merged
Conversation
`docs/make.jl` shipped `draft = true` globally with a `@meta Draft = false` block repeated across 43 pages to opt each one back into execution — a double negative, and it blocked a fast `draft = true` pass for link/nav checks. - `make.jl`: `draft = false` default (every page executes — what a published build must do); flip the one flag locally for a fast build. - Remove the 43 per-page `@meta Draft = false` blocks. - Remove the guided-tour `Draft = false` Literate injection. - Refresh the make.jl comments; trim the stale :example_block note (CTParser#341 closed). A page that must stay drafted now opts out with `Draft = true` in its `@meta` (one marker) instead of 43 pages opting in. Verified: full `julia --project=. docs/make.jl` with `draft = false` — exit 0, all @example/@repl blocks execute (figures embedded, computed values rendered), doctests run, @extref 0, @ref 0. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
ocots
added a commit
that referenced
this pull request
Sep 2, 2026
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #948.
Before
docs/make.jl:draft = trueglobal, and 43 content pages each carrying