Skip to content

[docs] v17.mdx 里 objectui pin 的另外两处口径仍停在 7d9734d5e321(区间 + 计数),需要一个可复现的计数口径 #4746

Description

@os-zhuang

PR #4744(docs-only,Fixes #4733)按单子要求只把 console 段标题的区间换成了 4a4829d0ef39 → 785b8a5d432c。落笔时发现同一页还有两处描述同一件事的文字跟着动 —— 单子明文限定「一个新条目 + 一处区间替换,不顺手修别的段落」,所以按仓规单开一单记录,不在那个 PR 里改。

未认领,谁接谁 assign。

现状(content/docs/releases/v17.mdx,以 #4744 合并后为准)

1. ## Landed since 17.0.0-rc.0 开头的引文(约 :1468)

…Console from the objectui pin advancing 4a4829d0ef39 → 7d9734d5e321(79 commits, released as objectui 17.1.0)。

.objectui-shamain 上已经是 785b8a5d432cf009389a1a9180fdac2a8297543f(#4732 合并),所以这个区间和标题段已经对不上了。

2. console 段标题下的正文第一句(约 :1919,#4744 改完标题后紧跟着的一行)

143 objectui commits across five pin moves, released as objectui 17.1.0.
(The pin changesets enumerate 79 of them; …)

标题现在覆盖到 785b8a5d432c —— 也就是第次 pin 移动 —— 正文却仍说 five pin moves / 143 commits。

为什么 #4744 没有顺手改

不是遗漏,是改不出可信的数:

  • 本地 objectui 克隆里 git merge-base --is-ancestor 4a4829d0ef39 7d9734d5e321 判定不是祖先,git rev-list --count 4a4829d0ef39..7d9734d5e321 只有 3 —— 显然不是「79 commits」「143 commits」的来源口径。
  • 所以原作者用的是别的计数方式(可能按 PR 数、按各次 pin changeset 枚举行数、或跨 objectui 的 PR 分支而非 main 线性历史),复不出来。
  • 在复不出口径的前提下把「five」改成「six」、把 143 改成某个新数字,是凭空造数 —— 比留着旧数更糟,因为旧数至少还能追溯到当初那次写作。

建议的处理方式(需要维护者定口径)

  1. 先定口径:这一族数字到底数什么?候选 —— (a) .objectui-sha 各次 pin 之间 objectui main 上的提交数;(b) 各次 pin changeset 枚举的条目数;(c) 该窗口内合并的 objectui PR 数。三者会给出三个不同的数,现在页面上「143 / 79 / five」三个数已经是两三种口径混着写。
  2. 口径定了就让它可复现:最好是一条脚本/命令写进注释或 scripts/,下一次 pin 移动时任何人(含 agent)都能重算,而不是每次靠人肉记账 —— 这一族数字每次 pin 刷新都会失真一次,它现在的失效频率就是「每次 pin 刷新」。
  3. 然后一并把 :1468 的区间和正文计数更新到当前 pin。

同样是 docs-only,走独立 PR(CLAUDE.md 的 releases 页正门),skip-changeset 标签。

Refs #4733、PR #4744、PR #4732


Generated by Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationpm:queue

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions