Dots.

Now Loading

News

エンジニア向けドキュメントを、人が読みやすいHTMLで置く——Metaなどが進める公開の仕組み

ドキュメントとHTMLのイメージ図

アプリ開発やライブラリ利用のために書かれてきたエンジニア向けドキュメントを、人が読みやすいHTMLのドキュメントサイトとして公開する動きが広がっています。あわせて、同じ内容をAIツールが読み取りやすい形でも置く企業が増えており、その一例としてMetaの開発者向けドキュメントが挙げられます。

何が起きているのか

従来の開発者ドキュメントは、SDKやAPIの仕様が中心で、ページの構成もエンジニア向けに最適化されていました。近年は次の二層が意識されるようになっています。

  • 人向け: ブラウザで開くHTMLのドキュメント。見出し・手順・図が追いやすく、開発者以外でも参照しやすい
  • AI向け: ナビや広告などの装飾を除いたテキスト(Markdownや llms.txt など)。エージェントが正確に参照しやすい

Metaは Horizon OS 向けの開発者ドキュメントについて、Developer Center上の通常ページに加え、LLM向けに整理したドキュメント索引やページを公開しています。Unity、Unreal、Spatial SDK、Android、Native、Webなど、アプリ開発・ライブラリ利用で使う資料が対象です。

ドキュメント作業のイメージ(無料素材)

Metaの取り組みの要点

  • 開発者向けの正規の説明は、引き続きHTMLのドキュメントサイトで読める
  • AIツール向けには、装飾の少ないテキスト版や索引(llms.txt)を別途用意
  • Meta VR CLI や MCP 経由で、ドキュメントの検索・取得も可能

つまり、「エンジニア向けの正本」を捨てるのではなく、人が読むHTMLと、機械が読む整理済みテキストを並走させる形です。

他社でも似た動き

同様の公開方法は、Twilio、Cloudflare、PagerDutyなどでも見られます。HTMLのドキュメントサイトを保ちつつ、.md や llms.txt を足す例が増えています。

ドキュメントは「人が読むもの」から、「人とAIの両方が参照する基盤」へ移りつつあります。自社サイトやサービス説明でも、正本をHTMLで整え、必要に応じてAI向けの出力を足す考え方は、今後の標準に近づいていく可能性があります。

参考: