Docs as codeとマネージドプラットフォーム：2026年のトレードオフ
「Docs as code」— ドキュメントはGitに保存され、プルリクエストでレビューされ、CI経由でデプロイされます — は、エンジニアリング主導の企業で主流のパターンです。「マネージドプラットフォーム」— ログインし、設定して、公開する — は、デザイン主導の企業やインディー企業で主流のパターンです。どちらも機能します。どちらも異なる形で失敗します。
これが、2026年における率直なトレードオフです。
要約#
| コードとしてのドキュメント | 管理プラットフォーム | |
|---|---|---|
| ドキュメントの保存場所 | Git | プラットフォームのDBまたはGit |
| 編集 | IDEでMarkdownを編集、PRでレビュー | WebエディターまたはMarkdown |
| デプロイ | CI/CDパイプライン | プッシュするだけ |
| ホスティング | 自分で管理 | ベンダーが管理 |
| メンテナンス | 自社のエンジニアリング工数 | ベンダーの工数 |
| AI機能 | 自分で構築または統合 | 組み込み |
| コストの形態 | エンジニアリング工数 | サブスクリプション |
| 最適な対象 | エンジニアリング主導、OSS、高度なカスタマイズ | スタートアップ、個人開発、「今すぐ公開」 |
Docsbookが興味深いのは、その両方を兼ね備えている点です。Git内のソースファイル（自分のリポジトリ）と、それ以外のすべてを管理します。
「docs as code」が適している場合#
docs-as-codeが今なお適切なパターンである3つの理由：
1. エンジニアリングはすでに Git に存在する#
ドキュメントの執筆者がエンジニアであれば、ドキュメントに Git を使用することによる認知的負荷はゼロです。プルリクエスト、コードレビュー、ブランチプレビューなど、既存のエンジニアリングワークフローをすべて自然に拡張できます。
2. バージョン管理をコードリリースに合わせる#
コード変更に伴うドキュメントの変更は、同じPRに含めます。レビュアーはAPIの変更とドキュメントの変更を一緒に確認できます。CIではその両方をテストします。
3. 高度なカスタマイズが必要#
ドキュメントに React コンポーネント、カスタム Markdown 拡張機能、または OpenAPI 仕様からページを生成するビルドパイプラインが必要な場合は、Docusaurus、Nextra、または VitePress を使用した docs-as-code が適したパターンです。
「マネージドプラットフォーム」が優位になる場合#
マネージドが優位になる3つの理由：
1. ドキュメントの執筆者はエンジニアではない#
プロダクトマーケター、サポートチームのメンバー、CSリードは、ドキュメントを更新する必要に迫られることがよくあります。彼らにGitリポジトリへMarkdownのプルリクエストを送るよう求めると、更新の妨げとなる摩擦が生じます。ウェブエディターのほうが迅速です。
2. AI機能が必要だが、チームはそれらを構築しない#
AIチャット、AI翻訳、MCP、llms.txt、分析機能を提供するマネージドプラットフォームなら、それぞれをプロジェクトとしてではなく、スイッチ一つで利用できます。自分たちで構築する場合、それぞれが実際のプロジェクトになります。検索、評価ループ、ロケールごとのルーティングを備えた翻訳パイプライン、イベントストアなどです。ほとんどのチームにとって、ドキュメントのためだけにこれらの作業を行う十分な理由はありません。
3. デプロイメントの所有は価値ではなくオーバーヘッド#
セルフホスト型のドキュメントサイトに継続的に発生する作業は現実に存在しますが、予定には組み込まれていません。メジャーバージョンの移行、依存関係やNodeバージョンのずれ、誰も担当しないビルドの失敗、再承認や再ホスティングが必要な検索機能などです。そのどれも、読者に見えるものを公開するわけではありません。
平均値ではなく、自分のリポジトリを基準に価格を算出してください。過去4四半期に、コンテンツを変更せずにドキュメントインフラストラクチャを変更したコミット数を数えます。その数こそが、マネージドプラットフォームによって取り除かれるものです。
ハイブリッド: Docsbook#
Docsbook は、どちらのカテゴリにも明確には当てはまらないため、独特な存在です。
- 信頼できる唯一の情報源は GitHub リポジトリ（docs-as-code の特性）
- ホスティング、AI、検索、翻訳、分析、MCP は管理される（マネージドプラットフォームの特性）
- CI/CD パイプラインなし、
docusaurus.config.jsなし、swizzle なし（マネージドプラットフォームの特性） - PR とレビューは同じように機能する（docs-as-code の特性）
- ベンダーロックインなし — 利用をやめてもファイルは GitHub に残る（docs-as-code の特性）
このパターンが重要なのは、純粋な docs-as-code の失敗要因（デプロイの負担）と、純粋なマネージド型の失敗要因（ベンダーロックイン）が相殺されるためです。
コスト計算#
一般的なエンジニア5人のスタートアップにおける24か月間の総保有コストを比較してみましょう。
純粋なdocs-as-code（Vercel上のDocusaurus）#
| 項目 | 24か月間のコスト |
|---|---|
| 有料プランでのホスティング | 気づくことのない定期請求 |
| 初期設定 | 一度きりのエンジニアリング工数 |
| メジャーバージョンの移行 | 2年間でおよそ2回発生するエンジニアリング工数 |
| 四半期ごとのメンテナンス | 定期的かつ予定外に発生するエンジニアリング工数 |
| AIチャットの構築 | エンジニアリング作業数週間分に加え、検索品質に対する継続的な責任 |
| AIチャットの運用 | ベクトルストア、埋め込み、モデル呼び出しの月額費用 |
| 検索（Algolia DocSearch、またはセルフホスト） | 承認されれば無料、それ以外の場合はサブスクリプションまたは追加の工数 |
| 翻訳パイプライン | 通常は省略される。項目別のコストではなく、プロジェクトとして扱われるため |
管理対象側#
| 項目 | 24か月間の費用 |
|---|---|
| サブスクリプションまたは従量制利用 | ベンダーの提示額 — ベンダー自身の料金ページで確認 |
| 初期設定 | 1時間未満 |
| メンテナンス | なし |
この比較を実際に行う方法#
両方の表に、こちらの数字ではなく、ご自身の数字を記入してください。ここでは意図的に金額を記載していません。正直な数字は、あなたのホスティングプラン、エンジニアの総人件費、トラフィックだけだからです。
記入し終えたら、注目すべき点が2つあります。第一に、セルフホストの列ではエンジニアリングの時間が大きな割合を占めますが、これは誰も予算に計上しない項目です。第二に、セルフホスト側の翻訳の行は、ほとんどの場合空欄になります。翻訳に価値がないからではなく、プロジェクトとして採算の基準を満たすことがないためです。つまり、その点を明示しない限り、この比較は同じ条件での比較にはなりません。
（Docsbookでは以前、買い切りの生涯PROプランを販売していましたが、現在は提供していません。既存の生涯プラン購入者には、購入時の契約条件が引き続き適用されます。）
コスト計算が逆転する#
docs-as-codeの方が安くなる3つのケース：
- エンジニアの工数が無料 — ドキュメントプラットフォームを専任で担当するエンジニアがいて、給与がいずれにせよ固定されている
- コミュニティコントリビューターがいるOSS — コミュニティからのPRによってメンテナンスの負担を吸収できる
- ドキュメント内のカスタムReactコンポーネント — マネージドプラットフォームではこれを実現できない
このようなケースでは、DocusaurusまたはVitePressが適切な選択です。それ以外の場合は、計算上マネージドの方が有利です。
ベンダーロックイン：評価方法#
マネージドプラットフォームに尋ねるべき3つの質問：
- 今すぐコンテンツをプレーンなMarkdownとしてエクスポートできますか？ できる場合、ロックインは低いと言えます。
- 移行してもURLは維持されますか？ ほとんどのサービスはURLの維持を許可していますが、そうでないものもあります。
- 解約した場合、カスタムドメインはどうなりますか？ 取得できるべきです。
Docsbookは3つすべてで高い評価を得ています。ファイルはGitHubリポジトリにあるため（エクスポート = git clone）、URLはファイルパスと一致し（維持 = リダイレクト）、カスタムドメインは自分で管理するDNSレコードです。
GitBookは1つ目（コンテンツが同社のデータベースにある）の評価が低く、他の2つは高い評価です。Mintlifyは3つすべてで高い評価を得ています。
選定基準#
- エンジニア主導、OSS、高度なカスタマイズ → コードとしてのドキュメント（Docusaurus、VitePress、Nextra）
- 個人開発、スタートアップ、「今すぐリリース」 → マネージドプラットフォーム（Docsbook、Mintlify）
- 30人以上の編集者を抱えるエンタープライズ → マネージドエンタープライズ（GitBook）
- ハイブリッドを求める → Docsbook（Gitソース、その他はすべてマネージド）
関連する記事#
Docsbookはハイブリッド型です。ソースはGitに保持しながら、AI、SEO、翻訳、MCPを管理できます。料金はプラン制ではなくAIの使用量に応じた従量制です。最新の料金についてはdocsbook.io/pricingをご覧ください。