Docusaurus

Docusaurus とは何か

Docusaurus（github.com/facebook/docusaurus）は、オープンソースプロジェクトのウェブサイトを簡単に構築・公開・維持するためのプロジェクトだと自称しています。実体は、ドキュメントを第一級の存在として扱う React ベースの静的サイトジェネレーターです。npm init docusaurus@latest というコマンド1つで、ドキュメント区画もブログも単独ページもテーマも揃ったサイトができるため、初日は技術構成を組み立てるのではなく中身を書くことに使えます。Meta が公開したのは、社内で走る多数のオープンソースプロジェクトを回すのに役立つからだと説明されています。コードは MIT ライセンスで、リポジトリ内のドキュメント本文には別途 Creative Commons ライセンスが付いています。

• コンテンツ種別はそれぞれ別プラグイン — ドキュメント用、ブログ用、単独ページ用に別々の公式パッケージが用意されているため、ドキュメントだけのサイト、ドキュメント＋変更履歴、あるいはマーケティング用トップページまで含む完全なサイトを、2つ目のツールを持ち込まずに構成できます。
• 普通なら後付けする部品が最初から揃っている — サイトマップ生成、Algolia による検索、URL を移したときのクライアント側リダイレクト、翻訳、PWA 対応、Mermaid 図、画像最適化、Google の解析タグが、いずれも同じリポジトリ内で保守されるパッケージとして存在します。
• 執筆形式は MDX — ページは React コンポーネントを埋め込める Markdown です。だからこそ、実質はリポジトリ内の1ファイルにすぎないページの中に、動くコードブロックや対話的な例を置けます。

ドキュメント、ブログ、マーケティングページは別々の仕事

ドキュメントサイトを無駄にする最もよくあるやり方は、それを単なるコンテンツ面の1つとして扱い、全部を同じ数字で評価することです。この3つの面は、それぞれ違う状態で到着する違う人を引き寄せます。そして、あなたを一度も聞いたことのない人に見つけてもらおうとしているのは、そのうち1つだけです。

Docusaurus は3つとも喜んで受け入れます。そこが罠です。同じビルドで出てくるせいで、まとめて1つのものとして評価されてしまいます。何より先に、レポートを分けてください。ドキュメントページとランディングページはトラフィックの表では見分けが付かないのに、まったく別の問いに答えています。出版の側こそが本業ならGhostがそのために作られていますし、プルリクエストを開かない人のための編集画面が必要ならPayloadです。

ドキュメントサイトはグロースのどこに収まるか

ドキュメントは、多くの開発者向けツールが持つ中で最も意図の強いコンテンツであり、最も安定して投資不足になる領域でもあります。特定の種類のクエリでは検索にも効きます。開発者はエラーメッセージ、API や関数の名前、「このツールでこれをどうやるか」という言い回しを検索します。競合が薄く意図が強いクエリ群で、正確な答えを書けば、競争の激しい主要語に必要な労力なしに取れます。これは本物の獲得面ですが、幅は狭い。そうしたクエリのほぼすべてに、すでにあなたの製品名か、あなたの製品が生んだ問題が含まれているからです。ドキュメントは既にあるものを増幅するのであって、ゼロから始めるものではありません。最初の注目をどう得るかは開発者向けツールのマーケティングで、1ページではなく主題そのものを持つ話はトピカルオーソリティで扱っています。

AgentCeres（agentceres.com のAI Growth Officer）を作る中での一次情報です。予想外だったのは、ドキュメントページとマーケティングページが解析レポート上ではまったく同じに見えるのに、正反対の仕事をしているという点でした。片方は検討中の人が読み、もう片方はすでに決めたうえで詰まっている人が読みます。気付けたのは、自社プロダクトのチャットに届く質問が、ほぼ一行単位で、私たちのドキュメントにあるべきだった見出しと一致していたからです。サポートのやり取りは、どんなキーワードツールよりも良い目次になります。製品が自明でなくなった正確な地点の一覧が、遭遇頻度順に並んでいるからです。今週 Docusaurus を入れるなら、最初に書くべき最も価値の高いページは機能紹介ではありません。すでに手で3回打った、あの質問への答えです。