Skip to content

docs: add What's new page, seeded with the October 19 update - #12

Open
yanboishere wants to merge 3 commits into
felinics:mainfrom
yanboishere:docs/whats-new
Open

yanboishere wants to merge 3 commits into
felinics:mainfrom
yanboishere:docs/whats-new

Conversation

@yanboishere

@yanboishere yanboishere commented Oct 30, 2026 •

Copy link
Copy Markdown
Member

发版公告放在哪里

参考 Codex 文档的做法,更新内容分成两个页面:

  • What's new(Codex):精选的更新速览,只收录会改变使用方式的变化。条目标题写用户能得到什么,配图,并链接到功能文档;其余改动引导读者去看 changelog。
  • Changelog(Codex):按版本穷举的完整记录,列出每个 PR,并链接到 GitHub Release。

我们 10 月 19 日在 X 上发的公告挑了 4 个亮点,其余用一句「Plus dozens of bug fixes and visual polish across the app」带过,配一张宣传卡片,没有版本号,属于 What's new。它对应的 changelog 已经存在:同一天发布的 v0.22.0 GitHub Release,约 20 项功能、70 项修复,其中修复大多是内部改动。产品「关于」页里的更新日志读的也是这份 Release。所以本 PR 只新增 What's new 页面,changelog 继续由 GitHub Releases 承担,What's new 的每一节都链接到对应的 Release。

本 PR 的改动

检查

  • 多语言一致性检查通过:每种语言 81 页、侧边栏 40 条链接。
  • 开启严格死链检查的 vitepress build 通过。
  • 在构建产物里确认四种语言的所有条目锚点和 acp#grok-build 都存在。

Release announcements (such as the October 19 post on X) are curated,
user-facing highlights, so they get a What's new page modeled on Codex's.
The exhaustive per-version changelog stays in GitHub Releases, which each
section links to; the docs keep no changelog of their own.

- docs/whats-new.md in en/zh/ja/ru: one dated section per announcement,
  verb-led entries with explicit ASCII anchors shared across locales,
  the announcement card image, and a link to the v0.22.0 release notes
- Top-nav item and a sidebar entry under References in every locale;
  two-level outline so readers can jump to individual entries
- Agents / ACP documents Grok Build (sign-in options, permission modes,
  no adapter needed), with a {#grok-build} anchor; it previously said
  only Codex and Claude Code ship
- CONTRIBUTING records what belongs in What's new versus release notes
  and the entry format; READMEs list the page
Keep the entry to the four highlights from the announcement; the section
still ends with the link to the full v0.22.0 release notes.

This branch has not been deployed

No deployments
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