ci: Extract docs versioning and release into reusable workflows#728
Merged
ci: Extract docs versioning and release into reusable workflows#728
Conversation
…workflow Extract the inline `version_docs` job from `manual_release_stable.yaml` into a standalone workflow that can be triggered manually or called from the release pipeline. Key improvements: - Fix `api:version` ENOENT bug by running docusaurus commands through `uv run` - Clean up ALL versions for the same major (not just exact major.minor match) - Remove non-docs artifacts (pyproject.toml, .gitignore, caches) from snapshots - Align doc_release ref to use version_docs_commitish instead of default_branch Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
vdusek
added
adhoc
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## master #728 +/- ##
==========================================
+ Coverage 95.28% 95.42% +0.13%
==========================================
Files 45 45
Lines 5114 5114
==========================================
+ Hits 4873 4880 +7
+ Misses 241 234 -7
Flags with carried forward coverage won't be shown. Click here to find out more. ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Query versions.json for the specific existing version for a given major
instead of aggressively globbing version-${MAJOR}.*. This means:
- Major release (e.g. 3.0.0): nothing is deleted (new major, no prior minor)
- Minor release (e.g. 3.1.0): only the exact old minor (3.0) is removed
- Patch release (e.g. 3.1.1): only the exact current minor (3.1) is removed and recreated
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…cs artifacts Add gitignore patterns for pyproject.toml and .gitignore inside website/versioned_docs/ so git add never stages them. This replaces the explicit rm commands in the workflow since changelog.md, .ruff_cache, and .ty_cache are already covered by existing patterns. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Pass inputs and context values through env variables instead of
direct ${{ }} interpolation in run: blocks. Affected workflows:
- manual_version_docs.yaml (inputs.ref, default_branch, step outputs)
- manual_regenerate_models.yaml (inputs.docs_workflow_run_id, github context)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…kflow Match the structure of `manual_version_docs.yaml` so it can be triggered both from the GitHub UI (with an optional ref input) and from other workflows. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
vdusek
changed the title
manual_version_docs.yaml workflow
Pijukatel
approved these changes
Apr 16, 2026
Contributor
Pijukatel
left a comment
Pijukatel
left a comment
There was a problem hiding this comment.
I would prefer to have this defined once in the workflow repo.
Similar:
apify/crawlee-python#1846
#728
apify/apify-sdk-python#857
apify/apify-client-js#876
Contributor
Author
Let's go step by step, merge it, migrate to pnpm, see whether everything works, and then try to extract the general part to the workflows. |
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
3 participants
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
Docs versioning (
manual_version_docs.yaml):version_docsjob frommanual_release_stable.yamlinto a standalone reusable workflowapi:versionENOENT bug by running docusaurus commands throughuv rundoc_releaseref to useversion_docs_commitishinstead ofdefault_branchDocs release (
manual_release_docs.yaml):_release_docs.yamltomanual_release_docs.yamlto match the naming conventionrefinput toworkflow_dispatchso it can be triggered from the GitHub UI with a specific ref (falling back to the default branch)CHECKOUT_REFenv var approach with aDetermine checkout refstep, consistent withmanual_version_docs.yamlmanual_release_stable.yamlandon_master.yaml🤖 Generated with Claude Code