LTする方が少なかったので、自分がやってる知見的な事を紹介するためのブログ。 API ドキュメント OpenAPIで書いています。 初めて聞いた人向けの説明 Swagger Editorで書くと、 Swagger UIみたいな見た目のドキュメントが作れる。 ファイルの置き場所 #{Rails.root}/doc/api/openapi.yml に1ファイルで置いてあります。 更新するとき #{Rails.root}/doc/api/docker-compose.yml を作っておきます。 version: "3.7" services: editor: image: swaggerapi/swagger-editor ports: - "8080:8080" ui: image: swaggerapi/swagger-ui ports: - "8081:8080" volumes: - .