Skip to content

docs: track 0.15.3, which is what pip install now gives you - #128

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

fas89 merged 1 commit into
mainfrom
chore/pin-0153

Conversation

@fas89

@fas89 fas89 commented Sep 15, 2026

Copy link
Copy Markdown
Collaborator

data-product-forge v0.15.3 is on PyPI (26 releases). The pin follows it — never the other way round, because cli-consistency.yml runs pip install data-product-forge==<pin> on every PR.

Why there was a second patch in one day

0.15.2 removed the documentation links that went nowhere. It left nineteen that went somewhere:

docs.fluid.io resolves, returns 200, and serves "Contracts Overview | Fluid Technical Docs — Financial system of the future" — an unrelated fintech. fluid validate printed it into its own error output:

  ❌ Unknown provider 'redshift'
  📚 Docs: https://docs.fluid.io/providers

A dead host announces itself. A live one sharing our product word does not.

18 references, 15 files, all named by the gate

check_cli_docs.py listed every one — the repo-root README, the landing banner and its pip install line, vision.md, four provider baseline banners, two walkthrough banners, the CLI and providers index lines, getting-started's pin and tracking sentence, cli/mission.md, and two sdk-and-plugins/reference exact-pin examples.

One 0.15.2 is deliberately kept, on the landing page, in the sentence naming the patch releases with no notes page of their own. It now names all three and says what they were for. History is not rewritten to match today.

Verified

check_cli_docs.py   OK: fluid CLI version matches docs (0.15.3)
                    OK: all 1093 documented `fluid` invocations match the pinned CLI
                    OK: every version claim in docs/ agrees with the pin (CLI 0.15.3)
npm run docs:build  exit 0
check-dist-links    Clean, canaries passing

`data-product-forge` v0.15.3 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.

0.15.3 is the second front-door patch in a day, and the more serious one. 0.15.2
removed the documentation links that went NOWHERE; it left nineteen that went
SOMEWHERE. `docs.fluid.io` resolves, returns 200, and serves an unrelated
fintech's documentation, and `fluid validate` printed it into its own error output
on an unknown provider.

Eighteen references bumped across fifteen files, every one named by
check_cli_docs.py rather than found by hand. One `0.15.2` is deliberately kept, on
the landing page, where the sentence names the patch releases that have no
release-notes page of their own; it now names all three and says what they were
for. 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.3)" and all 1093 documented invocations against the newly
pinned CLI; build clean; the artifact link gate clean with its canaries passing.
@fas89
fas89 merged commit 2017637 into main Sep 15, 2026
9 checks passed
@fas89
fas89 deleted the chore/pin-0153 branch September 15, 2026 16:20

This branch was successfully deployed

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