OASの書き方を知っておきたい

[shamisonn]

前提としてOpenApiを使っていく場合、の話で。 OpenApiを使わない場合はこのチケットはclose。

• https://github.com/swaggo/swag を利用するかを検討
• or OAS3のymlの書き方ガイド(or 書き方ガイドへの外部リンク)をwikiに書く

いずれにしても、OASのドキュメントの更新を誰でも可能な状態にしたい

[unvavo]

若干学習コストかかりそうだなと思ったので、 https://stoplight.io/ 使ってみたけど、結構便利でした