DocDriven

DocDrivenとは

DocDrivenは、APIを支えるコードを誰かが書く前に、チームでAPIの形を決めるためのワークスペースだ。バックエンドはビジュアルエディタでエンドポイントを組み立て、フロントエンドは同じ定義を読んでコメントを残す。プロダクト担当はチャットで進捗を追わなくても変更が届くのを見られる。

狙っているのはよくある詰まりだ。仕様はあるツール、チケットは別のツール、実際の挙動は誰かの頭の中にある。ここでは定義、その周りの議論、モック応答、APIドキュメントが同じ場所に置かれる。フィールドを1つ変えれば、それに依存する全員に届く。

制約も先に書いておく。設計とドキュメントの層であって、実行環境ではない。サービスのデプロイとホスティングは自分で行う必要があり、AIコード生成が返すのは出発点のコードで、完成した本番ロジックではない。無料トライアルは1ワークスペースで30日間、終了後は有料プランを選ぶまでアカウントが停止する。

はじめかた

1. app.docdriven.comでサインアップする。30日間のトライアルは1ワークスペースですべての機能が有効になり、カード登録は不要だ。
2. ワークスペースを作り、APIに触る人を招く。フロントエンドの開発者も、読み取りだけ必要なゲストも含める。
3. ビジュアルエディタで最初のエンドポイントを組む。データモデルを先に描いてルートを導かせる手もある。
4. 下書きをレビューに回す。メンバーは特定のエンドポイントにコメントし、課題を起票し、担当者を決める。
5. モック応答を生成して、フロントエンドが合意した形に対して実装を進められるようにする。実装の土台が欲しいときはAIコード生成を有効にする。