プログラミングとソフトウェア開発

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

KubernetesやOpenTelemetryなどのプロジェクトのドキュメントに利用されているオープンソースプロジェクトDocsyが、Linux Foundationへ移管される。AIエージェントがドキュメントを読みやすくなる機能の開発が進められており、ドキュメントの発見、ナビゲーション、自動利用への適合度を測定する方法の追加にも取り組んでいる。

2026-10-07
1 分で読めます
246 閲覧数
certi.news Editorial Team
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、およびそれに関連する指示機能も任意選択で実験的なものであるため、実際の影響は、プロジェクトによる採用と、プロジェクトが作成する元のコンテンツの品質に左右される。

ニュースの出典
The New Stack - Software Development
原文を開く ↗
c
著者

certi.news Editorial Team

知っておくべきこと

オープンソースプロジェクトのDocsyはGoogleからLinux Foundationへ移管され、AIエージェントがドキュメントをより簡単に発見・理解できるようにする機能の開発が進められています。プロジェクトでは実験的にMarkdownページとllms.txtファイルの生成機能が追加され、ドキュメントの発見可能性、ナビゲーション性、自動消費のしやすさを評価する指標の開発も進められています。

  • Docsyは、静的サイトジェネレーターHugoを使ってドキュメントサイトを構築するためのオープンソーステーマで、2024年末時点で約2,200のプロジェクトが利用しています。
  • Kubernetes、OpenTelemetry、gRPC、Jaegerなど、Linux Foundationのプロジェクト群で広く利用されるようになったため、プロジェクトはLinux Foundationへ移管されました。
  • バージョン0.15.0以降、DocsyはページのMarkdown版と、サイトのコンテンツのインデックスを提供するllms.txtファイルを生成できます。ただし、両機能は任意かつ実験的です。
  • バージョン0.16.0では自動アシスタントが従えるアップグレードガイドが追加され、バージョン0.17.0ではllms.txtを有効にした際にエージェントをサイトのインデックスへ誘導する指示が追加されました。
  • Docsyチームは、AIエージェントがドキュメントを発見し、ナビゲートし、消費できる能力を測定するAF documentation scoresに取り組んでいます。
  • これらの機能を使っても、エージェントがドキュメントを正しく理解することが保証されるわけではありません。実際の効果は、プロジェクトによる採用状況と元のコンテンツの品質に左右されます。

よくある質問

Docsyプロジェクトとは何ですか?

Googleが作成した、静的サイトジェネレーターHugoを使って技術ドキュメントサイトを構築するためのオープンソーステーマです。

Docsyのllms.txtファイルにはどのような利点がありますか?

ドキュメントサイトのコンテンツのインデックスを提供し、AIエージェントをコンテンツへ誘導するのに役立ちます。ただし、この機能は任意かつ実験的です。

AF documentation scoresとは何ですか?

AIツールがドキュメントをどの程度発見し、ナビゲートし、消費できるかを評価するために、Docsyチームが開発を進めている指標です。

Docsyの新機能は安定版になりましたか?

いいえ。Markdown、llms.txt、およびそれに関連する指示機能は、任意かつ実験的なものとされています。

このストーリーを探る

関連トピックとエンティティ

同じカテゴリー

おすすめ記事

すべてのニュースを見る