Skip to content

website: Take released docs from a website/<tag> branch when present - #3292

Closed
huacnlee wants to merge 1 commit into
mainfrom
website/released-content-branch
Closed

huacnlee wants to merge 1 commit into
mainfrom
website/released-content-branch

Conversation

@huacnlee

Copy link
Copy Markdown
Member

Description

The v0.7.0 website still shows gpui-kit = "0.6". The cause is the content, not the build cache: the latest release is rebuilt on every run from the tag's docs and homepage, and v0.7.0 was tagged before #3284 replaced the hardcoded versions with {{gpui_kit_version}}. A published tag should not move, and correcting its docs should not require a new release.

script/build-website-versions now fetches website/* branches. When origin/website/<tag> exists, the docs and HomeApp.vue are snapshotted from it instead of the tag. GPUI_KIT_VERSION and GPUI_PRE_VERSION still resolve from the tag. The historical build cache key now includes the content commit, so an updated branch is rebuilt instead of served from cache.

The website/v0.7.0 branch is already pushed. It is cut from v0.7.0 and carries only the content part of adde487 (#3284): 19 docs files plus HomeApp.vue, identical line-for-line to that commit, with no other commits.

After merging, manually run Release Website from main. The automatic workflow_run trigger checks out the tag commit and would use the old script.

How to Test

  • bash -n script/build-website-versions passed.
  • script/snapshot-website . website/v0.7.0 <dir>: the snapshot has no gpui-kit = "0.6"; docs use {{gpui_kit_version}} and HomeApp.vue uses props.kitVersion.
  • The full versioned build was not run locally.

Checklist

  • Read CONTRIBUTING.md and followed its guidelines.
  • AI-assisted build-script change, reviewed.

🤖 Generated with Claude Code

A release tag cannot be changed after publishing, so its website content
can only be corrected by cutting a new release. v0.7.0 was tagged before
#3284 made the docs follow the Kit version, and the site still shows 0.6.

When `origin/website/<tag>` exists, snapshot the docs and homepage from it
instead of the tag; versions still resolve from the tag. Include the
content commit in the historical build cache key so an updated branch is
rebuilt.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@huacnlee

Copy link
Copy Markdown
Member Author

Not merging: the script change is only needed once to republish v0.7.0. Release Website is run from this branch via workflow_dispatch instead.

@huacnlee huacnlee closed this Sep 28, 2026
@huacnlee
huacnlee deleted the website/released-content-branch branch September 28, 2026 14:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant