どの .NET ビューア ライセンスが本当に必要ですか？ 完全ガイド
どの .NET ビューア ライセンスが本当に必要ですか？ 完全ガイド
API をクリーンに、バージョン管理された状態でリリースしたとき、次のハードルになることが多いのは ドキュメンテーション ビューア です。機能セットは概ね完璧ですが、ライセンス形態が見えにくい障壁となり、チームやパートナー、顧客への採用が遅れることがあります。
本稿では Doconut .NET ドキュメンテーション ビューアの 3 つの主要ライセンスオプション—Developer、Site、SDK—を分かりやすく解説し、最初から適切なプランを選べる実践的な意思決定フレームワークをご提示します。
目次
- API ドキュメントのライセンスが重要な理由
- Developer ライセンス – 小規模チームに最適
- Site ライセンス – ポータル全体でドキュメントをスケール
- SDK ライセンス – ビューアを自社製品に組み込む
- 意思決定マトリックス: クイックチェックリスト
- 最終考察 & 次のステップ
API ドキュメントのライセンスが重要な理由 {#api-ドキュメントのライセンスが重要な理由}
- コンプライアンス: ライセンスが正しくないと監査フラグが発生し、予期しない料金が請求される可能性があります。
- パフォーマンス: 特定のプランは高度なレンダリングパイプライン（OpenAPI 3.0、Swagger、RAML）やリアルタイム共同作業を解放し、ドキュメントを高速に保ちます。
- スケーラビリティ: 組織が成長するにつれ、コストモデルは完全に再設計することなく進化すべきです。
間違ったライセンスを選ぶとコストが膨らむだけでなく、Git 同期やロールベース編集、ホワイトラベリングといったモダン DevOps ワークフローに不可欠な機能が制限されることがあります。
Developer ライセンス {#developer-ライセンス}
誰が検討すべきか？
- ソロ開発者 または 小規模チーム（1‑5 名のエンジニア）で、社内ツールや概念実証を構築する場合。
- 1 つのビューアインスタンス を単一アプリケーションに埋め込む必要があるチーム。
- ドキュメントが単一のコードベースに密接に結び付いているプロジェクト。
コア機能
| 機能 | プロジェクトへの影響 |
|---|---|
| ネイティブ API 仕様レンダリング | OpenAPI、Swagger、RAML を箱から出したようにフルシンタックスハイライトでサポート。 |
| リアルタイム共同編集 | 1 プロジェクトに限定されたリアルタイム共同執筆。素早いイテレーションに最適。 |
| 無制限検索可能ドキュメント | プロジェクト内のすべての Markdown、HTML、YAML ファイルをインデックス化し、瞬時に検索可能。 |
| Git 同期 | 1 対 1 のリポジトリ同期—変更をプッシュし、更新をプルし、コードとバージョン履歴を同期。 |
料金概要
- 年間 1 開発者あたり $199（固定料金）。
- 席数やインスタンス数に応じた追加料金はなし。
選ばない方が良いケース
以下を予想する場合は、Developer ライセンスはコストボトルネックになりやすいです。
- 複数のドキュメントサイト（顧客ポータル、外部パートナードキュメント）
- 単一リポジトリを超えるスケール
例え: シングルサーブコーヒーポッドのようなものです—1 カップには最適ですが、賑やかなオフィスでは全体機械が必要になります。
Site ライセンス {#site-ライセンス}
誰が検討すべきか？
- エンタープライズチームで、内部ツールや公開 API ポータル、数百人が利用するナレッジベースを複数運用している場合。
- 一貫したブランディング と統合されたアクセス制御が全ドキュメントタッチポイントで必要な企業。
コア機能
| 機能 | 効果 |
|---|---|
| 無制限のビューアインスタンス | 任意の数の Web サイト、イントラネット、SaaS ポータルにビューアを展開可能。 |
| 集中ライセンス管理 | 組織全体でライセンスの割り当て、取り消し、監査を行うダッシュボード。 |
| チーム全体のライブ編集と RBAC | 著者、レビューア、管理者などの細かいロールでガバナンスを実施。 |
| マルチリポジトリ Git 統合 | モノレポや分散リポジトリを接続し、すべてのドキュメントセットを同期。 |
| 優先サポート & SLA | 24 時間以内の対応で、ダウンタイムを最小限に抑える保証。 |
料金概要
- 基本: 年間 $4,999 で最大 20 サイト。
- 追加サイト: 1 サイトあたり年間 $250。
価値が出るシナリオ
- 公開開発者ポータル を運営し、プロダクション API と常に同期させる必要がある。
- 社内ナレッジベースが 数十チームの単一真実源 として機能する。
- 手作業でのドキュメント更新コストがサブスクリプション料金を上回る。
例え: 単なる 1 台のガレージから、フルサイズの駐車場に拡張したイメージです—場所に余裕があり、毎回駐車スペースを探す必要がなくなります。
SDK ライセンス {#sdk-ライセンス}
誰が検討すべきか？
- 商用製品に .NET ビューアを組み込むベンダー（例: デスクトップ IDE、クラウドコンソール、オンプレミスプラットフォーム）。
- ホワイトラベリング とソースレベルのカスタマイズが必須のチーム。
コア機能
| 機能 | もたらす効果 |
|---|---|
| 完全なソースアクセス | レンダリングパイプライン、UI コンポーネント、独自認証統合を自由に改変可能。 |
| 無制限配布 | エンドユーザーへのインストール数に制限なくビューアを提供でき、席数料金は発生しません。 |
| ホワイトラベリング | Doconut のブランドを除去し、カスタムテーマで外観を統一。 |
| 専任テクニカルアカウントマネージャー | 統合ガイダンス、パフォーマンスチューニング、ロードマップ調整の直接窓口。 |
料金概要
- 一括料金: 永続権利として $12,499。
- オプション保守: 年間 $2,999（アップデート、セキュリティパッチ、サポートを含む）。
正しい選択となるケース
- 製品の 付加価値 が組み込みドキュメントに依存している（例: Visual Studio 拡張で API 仕様をインライン表示）。
- 無制限配布 が必要で、ビューアがソフトウェアの各コピーに同梱される。
- ブランド一貫性と ソースコードレベルのカスタマイズ が交渉不可。
例え: 車のエンジンブロックを自分で買い取るイメージです—初期投資は大きいですが、パワートレインを完全に所有し、好きなだけ走らせられます。
意思決定マトリックス: クイックチェックリスト {#意思決定マトリックス-クイックチェックリスト}
| 質問 | 推奨ライセンス | 理由 |
|---|---|---|
| ビューアが表示される場所は何ヶ所ですか？ | Developer → 1‑2 カ所 Site → 3 カ所以上 | Site ライセンスはインスタンス数の上限を撤廃します。 |
| エンドユーザーへビューアを配布しますか？ | SDK | 無制限配布とホワイトラベリングが必要です。 |
| ブランディングやソースコードアクセスが必要ですか？ | SDK | 完全なソースアクセスとブランド除去が可能です。 |
| 好みのコストモデルは？ | Developer → 年間従量課金 Site → 年間サイト単位 SDK → 前払いの資本投資 | 予算サイクルに合わせて選択できます。 |
Tip: このマトリックスをプロジェクトブリーフやスプリント計画書に貼っておくと、営業とのやり取りなしで最適なライセンスがすぐに分かります。
最終考察 & 次のステップ {#最終考察-次のステップ}
正しい .NET ビューア ライセンスを選ぶことは「ワンサイズフィットオール」ではありません。以下の 3 つの柱に基づいて判断します。
- 導入範囲 – 単一アプリ vs. 複数ポータル vs. 製品統合。
- 配布要件 – 社内利用のみか、商用製品に同梱するか。
- 予算サイクル – 年次の継続支出か、前払いの資本投資か。
チームのワークフロー、成長予測、財務制約を上記機能と照らし合わせることで、後々の高額なライセンスアップグレードを回避し、ドキュメントの流れをスムーズに保つことができます。
さあ、最適なライセンスを確定しましょう
- doconut.com/pricing にアクセスし、インタラクティブなセレクタで見積もりを取得。
- 「License Selector Worksheet」をダウンロードし、意思決定マトリックスの回答をマッピング。
- さらに詳しい説明が必要な場合は、ソリューションエンジニアとの 15 分間デザインコール を予約し、共同編集、API 仕様レンダリング、Git 同期のライブデモをご体験ください。
ドキュメント作成を楽しみながら、API がライセンスと同様に充実した環境で活躍することを願っています！