Docsy怎么了？随着AI代理成为读者，谷歌文档项目加入Linux基金会
内容提要
Docsy文档项目从谷歌迁至Linux基金会，因AI代理日益成为技术文档读者。Docsy是Hugo静态站点生成器的开源主题，已被Kubernetes等约2200个项目采用。新版可生成Markdown副本和llms.txt索引，并计划推出“代理友好文档评分”，帮助维护者评估AI可读性，同时减少维护负担。
延伸解读
AI成为文档新读者，Docsy转向代理友好
文章指出，技术文档的读者正越来越多地包括AI代理，这带来了新的发布和结构需求。Docsy已开始适配：自0.15.0版起可生成Markdown副本和llms.txt索引，0.17.0版进一步在页面顶部加入隐藏指令，引导代理访问llms.txt。这些功能均为可选且实验性，目的是让AI系统更直接地获取项目希望它们使用的信息。
迁入Linux基金会：靠近用户与社区
Docsy从谷歌迁至Linux基金会，部分原因是其已有大量采用者位于该基金会社区内，包括Kubernetes、OpenTelemetry、gRPC和Jaeger等。谷歌的Erin McKean表示，开源项目靠近用户时运作最佳。这一迁移可能使Docsy与现有用户社区的联系更紧密，但文章未提及迁移对项目治理或开发节奏的具体影响。
代理友好文档评分：可衡量但尚未落地
Docsy路线图包括“代理友好文档评分”，旨在让维护者评估AI工具查找、导航和消费文档的难易程度。McKean称这将提供基准，无需猜测即可衡量文档的代理友好性。不过，该评分尚未推出，具体指标和计算方式也未在文章中说明，读者需关注后续进展。
减轻维护者负担：良好文档的常规回报
除了适配AI，文章还提到良好文档的传统益处：减少可被文档直接回答的常规问题，从而降低维护者负担。McKean认为，无论信息通过何种途径变得有用，只要最终帮助到开发者即可。这一观点为Docsy的AI适配提供了实用主义依据，但文章未提供量化数据证明负担减轻的程度。
Q&A
Docsy项目为什么从谷歌迁移到Linux基金会？
Docsy迁移到Linux基金会是因为它已被Kubernetes、OpenTelemetry等约2200个开源项目采用，其中许多属于Linux基金会社区。将项目置于基金会下可以使其更接近用户，而开源项目在靠近用户时运作最佳。
Docsy是什么？它有什么用途？
Docsy是谷歌在2019年推出的开源Hugo静态站点生成器主题，专为技术文档设计。它可用于一般文档（包括专有项目），但在开源领域应用尤为广泛，截至2024年底已有约2200个项目使用。
Docsy为适应AI代理阅读文档增加了哪些功能？
自2024年5月发布的0.15.0版起，Docsy可以生成每个页面的Markdown副本以及llms.txt索引文件（均为可选且实验性）。7月的0.16.0版提供了可供AI助手遵循的升级指南。8月的0.17.0版在启用llms.txt的站点上，每个页面顶部会自动添加隐藏指令，引导AI代理访问llms.txt索引。
什么是“代理友好文档评分”？它有什么作用？
“代理友好文档评分”（AF文档评分）是Docsy路线图中的功能，旨在让维护者评估AI工具查找、导航和消费其文档的难易程度。它提供了一个可衡量的基准，维护者无需猜测即可测量文档对代理的友好程度。
AI成为技术文档读者对文档维护者有什么好处？
更好的文档可以减少维护者的负担。好的文档能自动回答那些原本需要人工介入的常规问题，从而减少落在维护者身上的问题数量。
Docsy的llms.txt功能目前是什么状态？
llms.txt功能目前是实验性的，并且需要站点主动选择启用。启用后，站点会自动在每个页面顶部包含一个隐藏指令，指向站点的llms.txt索引，以帮助AI代理获取内容。
