Docsbookブログ:ドキュメント戦略と比較
ドキュメントを単なる作業ではなく、チャネルとして運用するための長文記事です。ここに掲載するすべての記事は、プロダクト企業でドキュメントを担当し、そのための時間を正当化しなければならない人に向けて書かれています。
記事は公開日ではなく、今取り組んでいる業務ごとに分類されています。つまり、前四半期に書かれた比較記事でも、今週プラットフォームを選ぶ際に開くべきページであることに変わりはありません。
まだ存在しないドキュメントを公開したい#
ドキュメントがREADME、Wiki、またはどこにもない場合は、ここから始めてください。
- README.mdを本格的なドキュメントサイトに変える — 1つのファイルからサイトを作成する最短ルート
- GitHubリポジトリからドキュメントをホスティングする方法 — 3つの方法を比較し、それぞれの設定手順を紹介
- READMEだけのプロジェクトにドキュメントサイトが必要な理由 — 1つのファイルだけではどこまでが限界なのか
- ドキュメント用カスタムドメイン:docs.yourcompany.comの設定 — DNS、SSL、リダイレクトを一度で設定
ドキュメントプラットフォームを選んでいます#
徹底比較。それぞれ、相手の製品が勝るケースを紹介します。
- 2026年、スタートアップに最適なドキュメントプラットフォーム — 8つのプラットフォームを企業の成長段階別にランキング
- 2026年のDocusaurus代替サービス:9つのプラットフォームを比較 — マネージド型とセルフホスト型を含む全体像
- GitBookとDocsbookの比較 — 料金体系とコンテンツの保存場所を比較
- MintlifyとDocsbookの比較 — 設定、AI、多言語SEOを比較
- AIドキュメントプラットフォームの比較 — 4つのマネージドツールでAIが実際にどのように実装されているか
- 無料ドキュメントホスティングの比較 — 無料で利用する6つの方法と、それぞれにかかる時間
- Docs as codeとマネージドプラットフォームの比較 — 同じ選択を原則として捉え直す
すでにどこかでドキュメントを運用していて、移行したい#
- 2026年にDocusaurusから移行すべきか? — 移行前の判断
- DocusaurusからDocsbookへの移行:ステップごとの手順 — MDX、CIの整理、リダイレクト
- GitBookからDocsbookへの移行 — エクスポート、インポート、カスタムドメイン、リダイレクト
- プロダクトドキュメントでNotionの使用をやめた理由 — wikiがドキュメントではなくなる境界
すでにあるドキュメントを見つけてもらいたい#
まずは検索エンジン、次にアシスタントです。両者は関連していますが、同じ問題ではありません。
- ドキュメント SEO:開発者向けドキュメントを検索上位に表示する方法 — このセクションの基盤となる内容
- 多言語ドキュメントの SEO — ロケールごとの URL と hreflang
- ドキュメント向け JSON-LD — 追加する価値のあるスキーマタイプと、リッチリザルトにつながらなくなった唯一のタイプ
- ドキュメント向け AI 検索 — 実際の質問に対してキーワード検索では何も返ってこない理由
- ドキュメントを ChatGPT に引用してもらう方法 — 実践的なチェックリスト
- ドキュメントにおける Perplexity の引用 — そのクローラーが実際に読み取る内容
- llms.txt の解説 — このファイルとは何か、そしてこのファイルをめぐる主張のどの程度が証拠によって裏付けられているか
ドキュメントを読者だけでなくAIエージェントにも役立つものにしたい#
- ドキュメント用MCPサーバー — Claude CodeとCursorがドキュメントを読み書きする方法
- docs-skills:AIエージェントのためのモジュール型機能 — MCPとコンテンツの間をつなぐレイヤー
- ドキュメント用AIチャット:自作と購入、どちらを選ぶべきか? — 検索パイプラインを所有するコスト
ドキュメントが機能していることを証明したい#
- ドキュメント分析:追跡する価値のある指標 — 検索に失敗した項目、回答されていない質問、行き止まり
- SaaSにとってドキュメントが重要な理由:隠れたROI — 自社プロダクトにおける不十分なドキュメントのコストを測定する方法
- 2026年の開発者向けAPIドキュメントのベストプラクティス — 企業が作成する中で最も重要度の高いドキュメント
内部#
- FAQ返信ノート — Reddit、X、Hacker News、IndieHackersのコミュニティコメント向けのコピー&ペースト用回答