Skip to content

content/docs/whats-new 的「Latest release」还停在 v5.0 / ObjectStack 5.0——应用已是 2.2.2 + 平台 17.0.0-rc.3 #1015

Description

@yinlianghui

Found while working #729(PR #1010)。PR #1010 刻意没有改这一页,因为它的「15 business objects」在 ### What's in v1.0 小节里、是 v1.0 的历史记录(与 test/docs-drift.test.ts#612 人格化守卫对这一页的豁免同一理由)。但在核对那处豁免是否成立时看到了这一页另一处不是历史记录的问题,记录如下。

现象

content/docs/whats-new.mdx(及 .zh-Hans / .zh-Hant)的结构是:

## v1.0 — HotCRM, the CRM that rewrites itself     (历史记录,正常)
...
## v5.0 — Latest release                           (现在时宣称)
The biggest release yet — a foundational upgrade plus a major documentation overhaul.
### Platform
- **🚀 Upgraded to ObjectStack 5.0** across all packages.
- **New** `@objectstack/console@5.0` and `@objectstack/account@5.0` available on npm.

「Latest release」是对今天的宣称,不是历史记录。实测:

该页声称 实测(origin/main acc37e65
最新版本 = v5.0 objectstack.config.ts manifest.version = 2.2.2package.json
平台 = ObjectStack 5.0 package.json@objectstack/* = 17.0.0-rc.3

平台差了 12 个 major。「v5.0」这个号既不是应用版本(2.2.2)也不是当前平台版本(17),来历不明 —— 有可能是历史上某次把平台版本当应用版本写下的残留。

另外这一页整体只有 v1.0 与 v5.0 两节,而应用当前是 2.2.2,中间发生过的事(#512 retire agents、#592 事件模型、#612 去人格化、17.x 平台升级等)在这一页上都不存在。对一个叫「What's New」的页面来说,这是它最主要的失效方式。

为什么 CI 没抓到

test/docs-drift.test.ts#1001 版本守卫(VERSION_DOCS)覆盖 RELEASE_STRATEGY.md / STATUS.md / ARCHITECTURE.md / README.md不含 content/docs/whats-new.mdx。PR #1010 新增的计数守卫则把这一页整体列为 HISTORICAL 豁免 —— 那个豁免对 v1.0 小节是对的,但也顺带遮住了这一节。

建议(需要产品先定一件事)

这一页要不要继续维护?

  • A. 要 —— 那就把「Latest release」一节按真实的当前版本重写,并明确这一页的更新时机(随 release 流程走,与 .changeset 编译出的 release notes 对齐)。守卫上可以把「标着 Latest release 的那一节必须写出 manifest 声明的版本」加进 docs: 全站去人格化 Copilot 称呼,并把版本号钉到 manifest (#612) #1001 的版本规则,让它和其他版本页一个待遇。
  • B. 不要 —— 那就把它收敛成纯历史归档(每节都带版本号、不再出现「Latest」字样),并在导航里改名,免得读者把它当现状读。

倾向 A:这一页在 content/docs/index.mdx 结尾被显式指过去(「Need to see what changed in the latest version?」),是有入口有流量的页面,放着不管等于对读者持续说错话。

⚠️ 注意:这一页与 content/docs/releases/ 无关,改它不违反「不在代码 PR 里改 releases」的规则;但它与 release 流程的关系需要在 A 方案里说清楚,避免变成第二个手工维护的发布表。

Filed unassigned。

Metadata

Metadata

Assignees

Labels

bugSomething isn't workingdocumentationImprovements or additions to documentationpm:dispatchedDispatched to a dev agent by /pm-dispatch

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions