Skip to content

docs(sweep): run 4 — rc.1 catch-up, close the run-2 coverage gap - #4600

Merged
os-zhuang merged 2 commits into
mainfrom
claude/v17-docs-update-nxjj6d
Aug 2, 2026
Merged

docs(sweep): run 4 — rc.1 catch-up, close the run-2 coverage gap#4600
os-zhuang merged 2 commits into
mainfrom
claude/v17-docs-update-nxjj6d

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

v17 文档扫描第 4 轮(独立 docs-only PR,遵守「releases 页不随 code PR 编辑」规则 —— 本 PR 未触碰 content/docs/releases/)。

覆盖缺口

docs/v17-docs-sweep.md 里只有 run 1(watermark a641d10)和 run 3(版本号专项)—— run 2 不存在,所以 a641d10..0f9faa2 之间新增的 362 个 changeset 从未做过移除指纹扫描。本轮 delta 因此取 a641d10..HEAD(435 个新 changeset、~48 条破坏性),树已在 17.0.0-rc.1

修复的漂移

文件 漂移
permissions/authorization.mdx gate 1 仍教 api.requireAuth: false opt-out —— #3963 已整体退役(tombstone,匿名一律拒绝,无部署级逃生口)
permissions/explain.mdx "even on requireAuth: false deployments" —— 该姿态已不存在
ui/forms.mdx 两处把 requireAuth 当可配置开关描述
kernel/services-checklist.mdx 变更时只更新了一半:叙述节写了 workflow 槽位退役(#4451),但页面仍称 16 个服务、架构图仍列 workflow、汇总表仍保留其行。现改为 15(与 15 成员枚举核对)、删行、表格与章节编号对齐

判定非漂移(已记录,下轮免重判)

新指纹命中的其余位置在变更时就写对了:flows.mdx(#4343 script 收敛的退役 callout)、query-syntax(#4286 移除 + having enforced)、error-catalog(ADR-0114 fieldErrors tombstone)、bulkActionDefs(#4457 新 typed shape);validating-metadata / objectstack-ui skill 的 actionType 是 dashboard 按钮的同名不同表面。十四个指纹零命中(validateOnlyreadReplicasregisterStandardEndpoints、dual-source 名字等)。

方法论记录(写进 playbook)

这个窗口的 docs-at-change-time 纪律明显变好 —— 幸存的漂移都是二阶的:页面局部更新(checklist 总数 vs 叙述)、或变更没碰到的页面里的交叉引用(explain/forms 里的 requireAuth)。指纹要 repo 级 grep,主页面看着改完了也不能跳过。

验证

  • pnpm docs:build 通过
  • check:release-notes / doc-authoring / role-word / org-identifier / nul-bytes 全绿
  • 纯文档,无 changeset(.changeset 未动 —— docs-only,releases nothing;若 Check Changeset 需要,可补空 changeset)

🤖 Generated with Claude Code

https://claude.ai/code/session_01LXvaYR7TiJBCxYwjn51owH


Generated by Claude Code

The sweep log holds run 1 (watermark a641d10) and run 3 (a version-number-only
pass) — no run 2 was ever recorded, so the 362 changesets added a641d10..0f9faa2
were never swept with removal fingerprints. This run's delta is a641d10..HEAD
(435 new changesets, ~48 breaking), against a tree now at 17.0.0-rc.1.

Fixed drift:

- permissions/authorization.mdx — gate 1 still taught the api.requireAuth:false
  opt-out; #3963 retired it outright (tombstoned, always-deny).
- permissions/explain.mdx, ui/forms.mdx — three more passages describing the
  requireAuth knob as configurable.
- kernel/services-checklist.mdx — partially updated at change time: the
  narrative documented the workflow-slot retirement (#4451) while the page
  still claimed 16 services, listed workflow in the architecture diagram, and
  carried its live summary-table row. Now 15 (matches the 15-member enum),
  row dropped, table and section numbering re-aligned.

Everything else the new fingerprints matched was already correct at change
time — flows.mdx (#4343 script convergence), query-syntax (#4286 removals,
having enforcement), error-catalog (ADR-0114 fieldErrors tombstone),
bulkActionDefs (#4457) — and fourteen fingerprints hit nothing at all. Run 4
appended to docs/v17-docs-sweep.md with the coverage-gap note and the
second-order-drift method lesson.

Verified: pnpm docs:build passes; check:release-notes, doc-authoring,
role-word, org-identifier, nul-bytes green.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LXvaYR7TiJBCxYwjn51owH
@vercel

vercel Bot commented Aug 2, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
objectstack Ignored Ignored Aug 2, 2026 9:47am

Request Review

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Aug 2, 2026
The Check Changeset gate counts changesets added by the PR itself; an
empty-frontmatter changeset is the sanctioned releases-nothing declaration.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LXvaYR7TiJBCxYwjn51owH
@os-zhuang
os-zhuang marked this pull request as ready for review August 2, 2026 09:58
@os-zhuang
os-zhuang added this pull request to the merge queue Aug 2, 2026
Merged via the queue into main with commit 45a5787 Aug 2, 2026
19 checks passed
@os-zhuang
os-zhuang deleted the claude/v17-docs-update-nxjj6d branch August 2, 2026 10:09
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 size/m tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants