ci: Extract docs versioning and release into reusable workflows#1846
Merged
ci: Extract docs versioning and release into reusable workflows#1846
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 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
vdusek
added
t-tooling
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## master #1846 +/- ##
=======================================
Coverage 92.34% 92.34%
=======================================
Files 157 157
Lines 10921 10921
=======================================
Hits 10085 10085
Misses 836 836
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 changelog.md, pyproject.toml, and .gitignore inside website/versioned_docs/ so git add never stages them. This replaces the explicit rm commands in the workflow since .ruff_cache and .ty_cache are already covered by global 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.ref, github.event.repository.default_branch, and
steps outputs through env variables instead of direct ${{ }}
interpolation in run: blocks.
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
Collaborator
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:
#1846
apify/apify-client-python#728
apify/apify-sdk-python#857
apify/apify-client-js#876
Collaborator
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 runDocs 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