Swaggerとは、RESTful APIを管理するためのフレームワークです。
ドキュメントや、サーバ、コード、エディタ、またそれらを扱うための仕様などを提供してくれます。
IBM、NTT Comunications、AWSといった大手の企業も採用されています。
swagger-editorなどを使いSwagger Specificationと呼ばれるAPIの動作を
YAMLまたはJSONのファイルを作成。
それを、Swagger Codegen に食べさせるとソースコードが出力される
また、Swaggerが出力したソースコードを取り込み、Swagger Specification
を作成することも可能なようです。