Checklist

Docs Site Agent Readiness Checklist

文档站点通常输赢都在结构上。如果 assistants 分不清 canonical guides、reference pages、导航路径和 setup flow,再深的内容也发挥不出应有价值。

最常见缺口
Canonical docs 路径不够清晰
最重要页面
Index、Setup、Reference、Policies
最好搭配
llms.txt + sitemap.xml

Checklist

文档公开面的第一轮检查

Canonical 结构
有明确的 docs home / index
Reference 和 guide 不被随意混放
最新 canonical 页面能压过过时重复页
导航清晰度
重要 setup 路径 1-2 次点击可达
面包屑、章节名、标题都足够明确
相关文档通过有意义的锚文本互链
信任与运营边界
Auth、limits、pricing、support boundary 容易找到
会影响真实使用的政策页公开可见
版本与时效性足够明显,避免模型读旧内容
机器可读层
robots.txt、sitemap.xml、canonical tags 已就位
llms.txt 优先指向 setup guides、docs index、reference pages
重要文档路径不只依赖隐藏的 client-side navigation

Use it well

这份 checklist 应该优先暴露什么

文档看起来很多,但 assistants 找不到一个明确起点。
Reference 和 guide 都存在,但边界太松,撑不起 canonical 理解。
Setup 页公开了,但 auth、pricing 或使用边界仍然难验证。
文档理论上可抓取,但关键路径仍然过度依赖 app-like navigation。

Related pages

Continue through the cluster

Next step

先评审真实 docs 公开面,再去调文件

先检查 setup、reference、policy 和 navigation 路径是否已经足够 canonical,再把 llms.txt 当作这套结构的支撑层来用。