はじめにこんにちは! フィフス・フロアの開発チームリーダーのnotozekiです。 最近、OpenAPIという技術を知りました。 OpenAPIは、いわゆる「Web API」の仕様を形式的に記述するためのフォーマットです。 OpenAPIに関連するツールもいくつか提供されており、たとえばOpenAPIのフォーマットに従って書かれた仕様から、開発用のAPIのスタブサーバを自動生成するツールなども存在します。 Web開発が多い弊社では、Web APIの仕様管理は長年の課題でした。 特に開発メンバーが増えてくるにしたがって、以下のような課題が浮かび上がってきています: 仕様に関する情報源がないため、「実装が仕様」のような状態になってしまっています。また、新しくプロジェクトに加わる人に、都度仕様を説明する必要があります。手動でのAPIドキュメントの整備も試みましたが、開発に比べて整備が後回しになり