Google 的 Docsy 项目转入 Linux Foundation，为人工智能代理准备文档

由 Google 创建、用于借助静态网站生成器 Hugo 构建文档网站的开源项目 Docsy，正在转入 Linux Foundation。在这一时期，技术文档已成为人工智能代理的直接信息来源，而不再只是面向开发者。

Google 开发者关系工程师、Docsy 指导委员会成员 Erin McKean 于周三在布拉格举行的 Linux Foundation 欧洲开源峰会上发表演讲时宣布了这一变动。此次转移在一定程度上源于 Docsy 在与该基金会相关的项目生态系统中的普及；截至 2024 年底，约有 2,200 个项目在使用 Docsy，其中包括 Cloud Native Computing Foundation 的 Kubernetes、OpenTelemetry、gRPC 和 Jaeger 等项目。

面向自动化受众的文档项目

Docsy 于 2019 年首次公布，是一个用于技术文档的开源模板，可与开源项目或私有项目结合使用。不过，近期的变化重点关注人工智能工具如何访问内容，以及这些工具执行与项目相关的任务时所需指令的形式。

自 5 月发布 0.15.0 版本以来，Docsy 能够为每个页面生成 Markdown 版本，同时保留常规的 HTML 版本；它还可以生成 llms.txt 文件，为网站内容提供索引。这两项功能均为可选的实验性功能。

7 月发布的 0.16.0 版本增加了升级指南，其编写方式使自动化助手能够遵循指南，其中包含条件、步骤和验证操作。8 月发布的 0.17.0 版本则在启用 llms.txt 的用户所访问的每个页面顶部加入了隐藏指令，将访问网站的代理引导至网站索引。这一功能同样仍处于实验阶段。

实际发生了哪些变化？

Docsy 正在将部分文档优化工作从单纯为人类阅读进行页面排版，转向组织内容，使模型和代理能够找到、理解并遵循这些内容。对于依赖贡献者或外部用户的项目而言，这可能意味着将人工智能工具引导至更清晰的指令版本，而不是让它们从公开的 HTML 页面中自行推断。

McKean 表示，更好的文档可以减少提交给维护者的常规问题，因为用户能够在维护者介入之前获得答案。这对项目而言是一项潜在的运营收益，但这本身并不意味着代理能够正确理解内容，也不意味着文档会自动变得准确。

下一步：衡量代理的可读性

Docsy 团队正在开发其称为 AF documentation scores 的指标，即衡量文档对代理适用程度的分数。目标是为维护者提供一种指标，用于评估人工智能工具发现、浏览和使用文档的能力，而不是仅仅依靠猜测。

目前，消息来源尚未说明这一指标的形式、最终标准或发布时间。此外，Markdown、llms.txt 及与其相关的指令功能均为可选的实验性功能，因此其实际影响仍取决于项目对这些功能的采用程度，以及项目生成的原始内容质量。