fix: Automate versioned documentation publication - #6763
fix: Automate versioned documentation publication#6763larrysingleton007 wants to merge 4 commits into
Conversation
Fixes feast-dev#6762 Signed-off-by: Larry Singleton <166439969+larrysingleton007@users.noreply.github.com>
|
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## master #6763 +/- ##
==========================================
- Coverage 47.09% 47.08% -0.01%
==========================================
Files 419 419
Lines 51878 51878
Branches 7525 7525
==========================================
- Hits 24430 24429 -1
Misses 25700 25700
- Partials 1748 1749 +1
Continue to review full report in Codecov by Harness.
🚀 New features to boost your workflow:
|
|
v0.66.0 shipped while this PR was open and reproduced the gap it addresses. The release and version branch succeeded, but the public docs root and I merged current upstream @franciscojavierarceo @ntkathole, could one of you review the future-release automation when you have a chance? |
Signed-off-by: Larry Singleton <166439969+larrysingleton007@users.noreply.github.com>
|
Added the standalone publish option discussed in Slack. Setting |
What this PR does / why we need it:
Minor releases currently finish without creating their maintenance branch or advancing the public GitBook version. This adds a post-release job that creates or verifies the version branch, imports it into GitBook, publishes it, and confirms it became the default.
The release workflow can also publish documentation for an existing release without rerunning the release jobs. Maintainers provide the released version and can preview the operation with the default dry-run setting before publishing. The standalone path does not move
stableor create a release.The helper is safe to rerun. It reuses matching resources, refuses to move a conflicting maintenance branch, and keeps the previous documentation default until the new import succeeds. The release guide now covers the required GitBook configuration, standalone publishing, and manual recovery path.
Which issue(s) this PR fixes:
Fixes #6762
Checks
git commit -s)Testing Strategy
Ran the 10 focused unit tests, Ruff, repository pre-commit hooks, YAML parsing, a credential-free v0.66.0 dry run, and
git diff --check. Live GitBook validation still requires a maintainer-owned test site and scoped token.