tl;dr swaggerを使うとWebAPIの仕様書を決められたフォーマットに沿って作成できる API更新に追従して仕様書の自動更新ができる 将来的にはWebAPI仕様書の標準フォーマットになるかも？ メモ swagger coreとcodegenの役割が少し曖昧になっているから、明確化したい。 swaggerとは swaggerはREST APIのドキュメント記載に関するフォーマット仕様 RESTful API標準化団体(Open API Initiative）が採用。OpenAPI Specificationとして定義されている。 実態はJSON(YAML)形式のAPI仕様書とそれを取り巻くツール群 swaggerプロジェクト自体はフォーマット仕様以外にもドキュメントを書きやすくするツール、ドキュメント自動生成、ウェブベースのドキュメントビューワ等を提供している。 swaggerでの
