Swagger定義の管理場所について、 コード上に定義する方法 定義ファイルを直接管理する方法 API管理サービスを利用する方法 と、それぞれまとめました。 1. コード上にコメントとして記述する JavaDocのように、コード上のコメントとしてannotationで記述していく方法です。Swaggerを利用するにあたり、真っ先に思い浮かべるお馴染みの記述方法ではありますが、やはり一長一短があります。 長所 コード自体がリポジトリ管理されることで、APIの記述を別に管理する必要が無い。 *開発時にAPIのドキュメントの整合性が保たれやすい 短所 運用時においてはメンテナンスが行いにくい。 新規開発時なら導入はスムーズだが、すでに外部記述となっていた場合には相応のコストが掛かる。 annotationのコード補完が、エディタに備わっていない。 コード自体が長くなり、見通しの面ではデメリットに