Skip to content

docs: track 0.15.1, which is what pip install now gives you - #124

Merged
fas89 merged 1 commit into
mainfrom
docs/pin-0.15.1
Sep 14, 2026
Merged

fas89 merged 1 commit into
mainfrom
docs/pin-0.15.1

Conversation

@fas89

@fas89 fas89 commented Sep 14, 2026

Copy link
Copy Markdown
Collaborator

cli-version.json pinned 0.15.0, so cli-consistency.yml was installing and validating against a superseded release while readers got 0.15.1.

0.15.1 is a front-door patch with no behaviour change, so no page needed rewriting — only the pointers moved.

What the sweep got right

It flagged 16 current-pointer claims — release bullets, pip install data-product-forge== specs, "this docs set tracks" — and left every "as of 0.15.0 the engine enforces" statement alone.

That distinction matters. Those "since" statements remain true, and a sweep that bumped them would turn every patch release into a wave of quiet falsehoods.

The last one was the root README

Caught by the same widening added two days ago precisely because that file sat outside every gate. My own fix list here was filtered to docs/ paths and missed it again — and the gate caught it.

That is the first time in this work a gate caught something I had missed, rather than the other way round.

Verification

Against the real published 0.15.1 wheel, not the working tree:

OK: fluid CLI version matches docs (0.15.1)
OK: all 69 CLI subcommands are documented (84 pages, subdirectories included)
OK: `fluid init --quickstart` emits fluidVersion 0.7.2 (matches pin)
OK: contract pins agree with the CLI's bundled schemas
OK: all 1093 documented `fluid` invocations match the pinned CLI
OK: every version claim in docs/ agrees with the pin

Site builds, 213 pages.

`cli-version.json` pinned 0.15.0, so `cli-consistency.yml` was installing and
validating against a superseded release while readers got 0.15.1.

0.15.1 is a front-door patch with no behaviour change, so no page needed
rewriting - only the pointers moved. The version sweep listed exactly which, and
its judgement is worth recording: it flagged 16 current-pointer claims (release
bullets, `pip install data-product-forge==` specs, "this docs set tracks") and
left every "as of 0.15.0 the engine enforces" statement alone. Those remain true
and must not move with a patch; a sweep that bumped them would turn each release
into a wave of quiet falsehoods.

The last of the 16 was the repo-root README, caught by the same widening that
was added two days ago precisely because that file sat outside every gate. My
own first pass here missed it again - the fix list was filtered to `docs/`
paths - and the gate caught it. That is the first time in this work that a gate
caught something I had missed rather than the other way round.

Verified against the real published 0.15.1 wheel: all six checks green,
including 1093 documented invocations and every version claim agreeing with the
pin. Site builds, 213 pages.
@fas89
fas89 merged commit 92925e5 into main Sep 14, 2026
8 checks passed

This branch was successfully deployed

1 active deployment
github-pages — b2563d36 Deployed Sep 14, 2026 by fas89 via deploy #156
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