Found during #13334(PR #13794)复核移交,out of scope,filed unassigned 供分诊。无严重度断言。
The shape
模块页头 docblock 里的 @module <path> 标记行被 build-docs 逐字渲染为发布参考页的开篇行——例如 content/docs/references/ui/sharing.mdx 以字面文本 @module ui/sharing 开篇。#13794 前 14 页如此,#13794 落地后(2 个真页头新加标记)为 16 页。
- skill 索引 extractor 已经过滤 at-sign 行(所以 skill 面干净);
- build-docs 渲染器没有同类过滤,于是生成器/工具机件文本进入客户可见页面。
修复方向(供分诊定路线)
渲染器补一个 tag 行 drop(仿照既有 os:check 标记的 drop 处理)即可一次清全部 16 页;cosmetic,但属于「机件外漏到发布面」类。
Refs
Found during #13334(PR #13794)复核移交,out of scope,filed unassigned 供分诊。无严重度断言。
The shape
模块页头 docblock 里的
@module <path>标记行被 build-docs 逐字渲染为发布参考页的开篇行——例如content/docs/references/ui/sharing.mdx以字面文本@module ui/sharing开篇。#13794 前 14 页如此,#13794 落地后(2 个真页头新加标记)为 16 页。修复方向(供分诊定路线)
渲染器补一个 tag 行 drop(仿照既有
os:check标记的 drop 处理)即可一次清全部 16 页;cosmetic,但属于「机件外漏到发布面」类。Refs
@module门落地处;其 PR 正文注明「the marker line renders on their published pages the same way today」——即本缺陷在 Select an import-list doc block as module description only on an explicit @module marker, and re-attach the eight wedged schema comments #13794 之前已存在于 14 页,非其引入)