Skip to content

docs: track 0.15.2, which is what pip install now gives you - #126

Merged
fas89 merged 1 commit into
mainfrom
chore/pin-0152
Sep 15, 2026
Merged

fas89 merged 1 commit into
mainfrom
chore/pin-0152

Conversation

@fas89

@fas89 fas89 commented Sep 15, 2026

Copy link
Copy Markdown
Collaborator

data-product-forge v0.15.2 is on PyPI, so the docs pin follows it.

Ordering, which is not optional. cli-consistency.yml runs pip install data-product-forge==<pin> on every PR. Bumping the pin before the release is published fails that job on an install that cannot resolve — so: publish, verify, then pin.

The sweep found what a grep would not

Bumping cli-version.json alone turned check_cli_docs.py red, and it named every disagreeing line in turn:

file line
README.md repo-root "Current CLI release documented here"
docs/README.md landing banner title, the pip install sentence, and the release-line bullet
docs/vision.md "Current CLI release baseline"
docs/providers/{aws,gcp,local,snowflake}.md Docs Baseline: banners
docs/walkthrough/{export-orchestration,universal-pipeline}.md baseline banners
docs/{cli,providers}/README.md index "release covered/examples use" lines
docs/getting-started/README.md the exact pin and the tracking sentence
docs/cli/mission.md, docs/sdk-and-plugins/reference/{trust-model,companion-packages}.md exact-pin examples

Fourteen files. That gate is the one I widened two sessions ago after it proved blind to the repo-root README — this run is it earning its keep.

Deliberately not changed

One 0.15.1 stays, on the landing page, where it names 0.15.1 and 0.15.2 as the two front-door patches with no release-notes page of their own. That is history, and history is not rewritten to match today.

Verified

check_cli_docs.py   OK: fluid CLI version matches docs (0.15.2)
                    OK: all 1093 documented `fluid` invocations match the pinned CLI
                    OK: every version claim in docs/ agrees with the pin (CLI 0.15.2)
npm run docs:build  exit 0, 213 pages
check-dist-links    Clean: 107,738 absolute references across 219 built pages
                    canaries: 5 resolved (3 exact, 1 index, 1 pretty), 1 missing-base, 2 missing-file

`data-product-forge` v0.15.2 is on PyPI. The pin moves after the release and
never before it: `cli-consistency` runs `pip install data-product-forge==<pin>`
on every pull request, so bumping ahead of publication fails that job on an
install that cannot resolve.

The version sweep did the work rather than a grep. Bumping the pin alone turned
the gate red and it named every disagreeing line in turn - the repo-root README
bullet, the landing page banner and its `pip install` sentence, the vision
baseline, five provider and walkthrough "Docs Baseline" banners, the CLI and
providers index lines, the getting-started pin and its tracking sentence, and
three exact-pin examples under sdk-and-plugins. Fourteen files, none of which I
would have found by hand.

One mention of `0.15.1` is deliberately kept, on the landing page: it names
`0.15.1` and `0.15.2` as the two front-door patches that have no release-notes
page of their own. That is history, and history is not rewritten to match today.

Verified: `check_cli_docs.py` green, including "every version claim in docs/
agrees with the pin (CLI 0.15.2)" and all 1093 documented `fluid` invocations
against the newly pinned CLI. Build clean, and the artifact link gate clean at
219 pages and 107,738 absolute references with its canaries passing.
@fas89
fas89 merged commit 0adc601 into main Sep 15, 2026
9 checks passed
@fas89
fas89 deleted the chore/pin-0152 branch September 15, 2026 08:03

This branch was successfully deployed

1 active deployment
github-pages — 6c80ac58 Deployed Sep 15, 2026 by fas89 via deploy #160
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