ci: add auto doc tag workflow#730
Draft
UtkarshBhatthere wants to merge 1 commit into
Draft
Conversation
Adds .github/workflows/auto-doc-tag.yml. Runs every 6h on main and publishes a new vX.Y.Z+doc tag when docs/ has changed since the last tag. Bumps minor when any commit subject since the previous tag matches ^feat(scope)?:, otherwise bumps patch. Idempotent on unchanged HEAD. Read the Docs builds the new version via its existing webhook on tag push. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Contributor
Author
|
converting to draft as it needs changes. |
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
1 participant
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.
Summary
.github/workflows/auto-doc-tag.yml. Cron every 6h plusworkflow_dispatch(withdry-runinput).vX.Y.Z+docbased on commits since the last+doctag:^feat(scope)?:→ minor, else patch.docs/has commits since the previous tag. No-op otherwise.v*+doctag.Why
Today's stable docs publish path is manual (tag + RTD dashboard activate). This automates the tag step so each docs change on
mainproduces a fresh stable version on RTD without operator intervention.Tag scheme
v<major>.<minor>.<patch>+docv20.1.0+doc→0007d2cfeat:since last tag → minor; otherwise patch. No automatic major bumps.Test plan
workflow_dispatchwithdry-run=trueafter merge; confirm summary shows expected next tag and no push.docs/commit on main; trigger workflow manually withdry-run=false; confirm tag pushed and RTD build kicks off.feat:commit and adocs:commit; confirm minor bump.🤖 Generated with Claude Code