GoogleのDocsyプロジェクト、AIエージェント向けのドキュメント整備に向けてLinux Foundationへ移管

Googleが静的サイトジェネレーターのHugoを使用してドキュメントサイトを構築するために作成したオープンソースプロジェクトDocsyが、Linux Foundationへ移管される。技術ドキュメントが開発者だけでなく、AIエージェントにとっても直接的な情報源となっている時期の移管となる。

この動きは、Googleの開発者リレーションズエンジニアでDocsy運営委員会のメンバーでもあるErin McKean氏が、水曜日にプラハで開催されたLinux Foundation Open Source Summit Europeで行った講演中に発表した。移管の背景には、Linux Foundationに関連するプロジェクト群のエコシステム内でDocsyが広く採用されていることもある。2024年末までに約2,200のプロジェクトがDocsyを利用しており、Cloud Native Computing FoundationのプロジェクトではKubernetes、OpenTelemetry、gRPC、Jaegerなどが含まれる。

自動化された読者へ向かうドキュメントプロジェクト

Docsyは2019年に初めて発表された。オープンソースおよび非公開プロジェクトで利用できる、技術ドキュメント向けのオープンソーステンプレートである。しかし最近の変更は、AIツールがコンテンツにアクセスする方法と、これらのツールがプロジェクトに関連するタスクを実行するために必要とする指示の形式に重点を置いている。

5月の0.15.0リリース以降、Docsyは通常のHTML版に加えて各ページのMarkdown版を生成できるようになった。また、サイトのコンテンツのインデックスを提供するllms.txtファイルも生成できる。いずれの機能も任意選択であり、実験的なものである。

7月にリリースされた0.16.0では、自動アシスタントが従えるように、条件、手順、検証作業を含むアップグレードガイドが追加された。8月にリリースされた0.17.0では、llms.txtを有効にしたユーザー向けに、各ページの上部へ非表示の指示が追加され、訪問するエージェントをサイトのインデックスへ誘導するようになった。この機能も実験的なものである。

実際に何が変わるのか

Docsyは、ドキュメント改善の作業の一部を、人間が読むためのページの整形だけでなく、モデルやエージェントがコンテンツを見つけ、理解し、従えるようにコンテンツを整理することへと変える。貢献者や外部ユーザーに依存するプロジェクトにとっては、AIツールが公開されたHTMLページから推測するのではなく、より明確な手順の版へ誘導されることを意味する可能性がある。

McKean氏によれば、より良いドキュメントは、回答がメンテナーの介入前にユーザーへ提供されるようになるため、メンテナーに寄せられる定型的な質問を減らせる可能性がある。これはプロジェクトにとって運用上の潜在的な利点だが、それだけでエージェントがコンテンツを正しく理解することや、ドキュメントが自動的に正確になることを意味するわけではない。

次の段階：エージェント向けの読みやすさを測定

Docsyチームは、AF documentation scoresと呼ぶ、ドキュメントがエージェントにどの程度適しているかを示すスコアに取り組んでいる。目標は、推測に頼るのではなく、AIツールがドキュメントを発見し、ナビゲーションし、利用できる能力を評価するための指標をメンテナーに提供することだ。

現時点で、この指標の形式や最終的な基準、リリース時期について、情報源は明らかにしていない。Markdown、llms.txt、およびそれに関連する指示機能も任意選択で実験的なものであるため、実際の影響は、プロジェクトによる採用と、プロジェクトが作成する元のコンテンツの品質に左右される。