← ClaudeAtlas

platform-docs-releaserlisted

Platform Documentation Release Skill
loft-sh/vcluster-docs · ★ 7 · API & Backend · score 60
Install: claude install-skill loft-sh/vcluster-docs
# Platform Documentation Release Skill ## Overview This skill automates the vCluster Platform documentation release process, handling API generation, version updates, configuration changes, and SEO setup for new Platform releases. ## Versioning Timing: rc-1 Process Starting with Platform v4.8, docs versioning happens at rc-1, NOT on release day. ### How it works 1. At rc-1: Create the new docs version the same day rc-1 is cut 2. Deploy hidden: The version is deployed but HIDDEN from the public version dropdown — users cannot discover it via the UI 3. Validation window: The hidden version can be accessed via Netlify preview URL or by manually changing the version in the URL, allowing the platform team and contributors to validate against real deployed docs 4. On release day: A single "config flip" PR exposes the version in the dropdown. This PR is small, reviewable, and safe to merge by anyone with merge rights 5. Backport flow: Contributors continue targeting `platform/` on `main` as usual. If a change needs to land in the upcoming release, add the `backport-v4.8.0` label to the PR ### Config flip PR (release day) The config flip PR changes only the version visibility in `docusaurus.config.js`: - Updates `lastVersion` to point to the new version - Adds the new version to the dropdown with "Stable" label - Demotes the previous stable version label (removes "Stable" suffix) - Updates SEO sitemap priorities, announcement bar, and netlify redirect This separation means a