在做 #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
在做 #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