swagger-api / swagger.io-docs

The content of swagger.io
https://swagger.io/docs/
1.56k stars 400 forks source link

You need to document TAG usage in both 2.0 and 3.0 specs #334

Open pm-david-simerly opened 1 year ago

pm-david-simerly commented 1 year ago

TAG is a really useful directive to organize specifications into different orders depending on precedence, importance, or whatever. The problem is that many of our engineers expect it to mean something else and misuse it, leaving it for the spec editors to clean up. It's a very simple directive to explain and useful to add to a spec. Please add it to your Swagger 2.0/OpenAPI 3.0 spec tutorials. Thx.