Fern

Fernは汎用テンプレートではなく、言語ごとの専門家が設計したクライアントライブラリを作る。生成されるSDKには強い型、インライン化されたドキュメント、見慣れたエラー処理が備わり、Python開発者もTypeScript開発者も、その言語らしく感じるものを手にできる。汎用ツールが出すOpenAPI SDKはここまで洗練されて見えることは少ない。これは重要だ。開発者が汎用ジェネレーターからの切り替えを選んだのは、扱いにくく使いづらいクライアントへの不満から逃れるためだったからだ。

ドキュメントはコードの残りと同じくリポジトリに置かれる。変更はGitを通り、レビュー担当者はプルリクエストで差分を見られ、どのコーディングエージェントも内容を起草・更新できる。インフラをすでにコードとして扱うチームはこの流れを自然に感じるだろうし、ドキュメントがAPIに遅れる原因になりがちなコピー＆ペーストの工程をなくせる。しっくりくる。古いページとはおさらばだ。

内蔵のAIチャットで、読者は質問し、ドキュメントから引き出した回答を得られる。回答が自社コンテンツに根ざしているため、モデルが一般知識から答えるときに生じる当たり障りのない返答を避けられる。特定のエンドポイントで詰まった読者にとって、これは役に立つ答えと、もっともらしく聞こえるだけの答えの違いになる。もう当てずっぽうはいらない。

FernはドキュメントとAPIをModel Context Protocolサーバー経由で公開し、自動生成したllms.txtファイルとともに整ったMarkdownを提供する。これらがそろって、構造化ドキュメントを読めるAIツールやコーディングエージェントがAPIを照会できるようになる。ユーザーがAIアシスタントで開発するなら、こうしたアシスタントにリアルタイムで調べさせる現実的な手段だ。

FernはREST、WebSockets、GraphQLに加え、AsyncAPIとgRPCプロトコルを受け付ける。スペック側ではOpenAPI、OpenAPI Overlays、OpenAPI Arazzo、AsyncAPI、gRPC、GraphQL、OpenRPC、そして独自の定義フォーマットを読む。この幅のおかげで、多くのチームは書き直す代わりに、すでに持っているスペックをFernに向けられる。向ければ動く。

無料プランにはカスタムドメインとサブパスが含まれ、有料プランではカスタムCSS、JavaScript、Reactコンポーネントに加え、カスタムレイアウトとデザインシステム連携が加わる。プレビューリンク、SEO最適化、非公開ドキュメント用のパスワード保護も設定でき、リファレンスサイトをブランドとアクセス規則の両方に合わせられる。必要なときに拡張できる。