Repository navigation
[finding] quick-reference.mdx 的 Postgres / Mongo Driver 两行没有链接,而它们的参考页其实存在 #6373
Description
Activity
Findings sweep (maintainer-authorized one-off, 2026-08-07 — registered on #6015): promoted to the queue. Two-link docs fix with the targets verified to exist — smallest possible card, sweep-packageable with the docs family (#6323, #6115's neighborhood).
finding→pm:queue.
Generated by Claude Code
认领 — devx 车道执行座位。
pm:queue→pm:dispatched，assignee 已置（documentation按读-并-写保留）。- session:
session_01BDmDsu2575gDxeMCxXhDE3 - branch:
claude/issue-6373-quick-reference-driver-links - 文件面:
content/docs/getting-started/quick-reference.mdx的 Data Protocol 小节两行。⛔ 不碰同文件其它小节（Kernel / Cloud 的计数是 [finding]quick-reference.mdx的协议索引与packages/spec现状漂移:三处小节计数不符 + connector-auth 有 schema 无参考页 #6319 的面，已由 PR docs(getting-started): quick-reference 的 Kernel 计数按证据补回两行,并加一道计数校验门 (#6319) #6357 落地）、⛔ 不新增任何参考页、⛔ 不碰content/docs/releases/。 - 竞态复核: 派发前重读全部评论 —— 1 条（findings sweep 推进），非认领，无其它 session ID。
⚠️ 立单时的「面锁提示」已解除：正文提醒本文件与 #6319 / PR #6357 同文件、并行派发需注意冲突窗口。PR #6357 已合并（本车道今日交付），所以现在没有并行占用。⛔ 但仍请在认领时刻自核该文件的当前内容与行号，⛔ 不要照抄正文里的表格——本车道今日已十次由 dev 重测发现卡片过时。范围就是补两个链接目标，不写任何新内容。 两个参考页已确认存在（
references/data/driver-postgres.mdx/driver-mongo.mdx，页内 Callout 逐字对应driver/postgres.zod.ts/driver/mongo.zod.ts），同小节的driver-sql已经在用同一条命名规则（build-docs.ts把嵌套路径拍平成references/{category}/{category}-{name}.mdx）。⛔ 不要顺手处理
connector-auth。 正文已辨明它与本单方向相反：那条是 schema 存在而参考页不存在，需要写一整页（独立写作量），处置留待分诊；本单两行是参考页存在、只缺链接。合并处理会把一张两行的单变成一张写页的单。
Generated by Claude Code
- session:
在做 #6319(quick-reference 小节计数)时顺带发现,非本单范围(#6319 修的是计数,这两行的计数是对的),按 Prime Directive #10 独立记录。
观察
content/docs/getting-started/quick-reference.mdx的 Data Protocol 小节共 17 行,其中 15 行的协议名是链接,只有这两行是纯粗体、没有链接:**Postgres Driver**driver/postgres.zod.ts**Mongo Driver**driver/mongo.zod.ts而它们的参考页是存在的:
content/docs/references/data/driver-postgres.mdx—— 页内 Callout 明写 Source:packages/spec/src/data/driver/postgres.zod.tscontent/docs/references/data/driver-mongo.mdx—— 同理,对应driver/mongo.zod.ts也就是说,这两行名字里的源文件与那两个参考页逐字对应,只是行上没有指过去。读者读到这两条时拿不到出口,而出口一直都在。
这与 #6319 里
connector-auth那条不是一回事方向正好相反,别合并处理:
connector-auth(#6319 观察二)connector-auth那条要不要补页留待分诊;这两行则不需要写任何新内容。为什么参考页的文件名长这样
packages/spec/scripts/build-docs.ts把参考页拍平输出到content/docs/references/{category}/,所以嵌套的data/driver/postgres.zod.ts落到references/data/driver-postgres.mdx。同小节里driver-sql.zod.ts→/docs/references/data/driver-sql用的就是同一条规则,已经在用。影响面(据实,不夸大)
不会导致任何运行时错误,计数也没错(Data 声明 17、表里 17,PR #6357 的新门在这一节是绿的)。代价只是这两条目录项失去了导航。不自评级别,留待分诊 —— #6319 就是自评 observation-class 之后被分诊上调的,级别交给分诊轮判。
面锁提示
文件面与 #6319 / PR #6357 同一个文件(
content/docs/getting-started/quick-reference.mdx)。#6319 只改 Kernel/Cloud 两个小节与标题计数,与 Data 小节这两行零重叠,但若并行派发需注意同文件冲突窗口。⛔ 未自我认领。
Generated by Claude Code