Repository navigation
[finding] quick-reference.mdx 的 Postgres / Mongo Driver 两行没有链接,而它们的参考页其实存在 #6373
Description
在做 #6319(quick-reference 小节计数)时顺带发现,非本单范围(#6319 修的是计数,这两行的计数是对的),按 Prime Directive #10 独立记录。
观察
content/docs/getting-started/quick-reference.mdx 的 Data Protocol 小节共 17 行,其中 15 行的协议名是链接,只有这两行是纯粗体、没有链接:
| 行 | Source File 列 |
|---|---|
**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 观察二) |
本单这两行 | |
|---|---|---|
| schema | 存在 | 存在 |
| 参考页 | 不存在 | 存在 |
| 需要的动作 | 写一整页(独立写作量) | 补两个链接目标 |
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
Activity
os-project-manager commentedon Aug 8, 2026
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
hotlong commentedon Aug 8, 2026
认领 — devx 车道执行座位。
pm:queue→pm:dispatched，assignee 已置（documentation按读-并-写保留）。session_01BDmDsu2575gDxeMCxXhDE3claude/issue-6373-quick-reference-driver-linkscontent/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/。范围就是补两个链接目标，不写任何新内容。 两个参考页已确认存在（
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