Skip to content

docs(release): reshape release notes for 0.10+#201

Merged
huhamhire merged 3 commits into
devfrom
chore/drop-early-preview-notice
Jul 5, 2026
Merged

docs(release): reshape release notes for 0.10+#201
huhamhire merged 3 commits into
devfrom
chore/drop-early-preview-notice

Conversation

@huhamhire

Copy link
Copy Markdown
Owner

Reshapes the GitHub Release notes template from 0.10 on. Source-of-truth changes for future releases; the already-published v0.10.0 Release body has been edited by hand to match.

Changes

  1. Drop the "Early preview (0.x)" banner — no longer carried from 0.10 on. RELEASE_NOTES.md-only (the CHANGELOG and website changelog never had it).
  2. Lead with per-language changelog deep-links — the website-changelog pointer moves to the top of the Release body and becomes two markdown links:
    📖 This release on the website changelog: [English](…/changelog#v0-10-0) · [简体中文](…/zh/changelog#v0-10-0)
    Each deep-links to this version on its locale's page (EN root, ZH under /zh/).

release.yml computes the slug from the tag and fills the new %%CHANGELOG_URL_EN%% / %%CHANGELOG_URL_ZH%% placeholders; sync-docs.mjs already emits the stable {#v…} anchor on both locales. packaging-release.md documents the rule.

Verification

Locally assembled the v0.10.0 body with the new template (awk section extract + placeholder fill) — no residual %%…%%, links resolve to #v0-10-0 on both locales — and applied it to the live v0.10.0 Release.

🤖 Generated with Claude Code

huhamhire and others added 2 commits July 5, 2026 17:53
From 0.10 on, the GitHub Release body no longer carries the early-preview
caveat. Removes the banner from RELEASE_NOTES.md — it lived only in the
release-notes template (the CHANGELOG and website changelog never had it).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The website-changelog pointer moves to the top of the Release body and becomes
two markdown links — `[English](…) · [简体中文](…)` — each deep-linking to this
version on its locale's changelog (EN root, ZH under /zh/). release.yml fills the
new `%%CHANGELOG_URL_EN%%` / `%%CHANGELOG_URL_ZH%%` placeholders; sync-docs already
emits the `{#v…}` anchor on both locales. packaging-release.md updated.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@huhamhire huhamhire added the documentation Improvements or additions to documentation label Jul 5, 2026
Trim the wordy "This release on the website changelog:" lead-in to a concise
"Full changelog:" — the language links and the deep-link anchor already carry
the rest of the meaning.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@huhamhire huhamhire merged commit 501a59e into dev Jul 5, 2026
3 checks passed
@huhamhire huhamhire deleted the chore/drop-early-preview-notice branch July 5, 2026 10:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant