Neoteroi / essentials-openapi

Functions to handle OpenAPI Documentation.
MIT License
21 stars 9 forks source link

Group response codes in tab group on MkDoc output? #35

Open Andre601 opened 10 months ago

Andre601 commented 10 months ago

Personally speaking, I feel like it would be a bit more useful to have the various Response codes grouped together in a tab group to toggle through.

Having them listed all at once can increase the page length for no real reason, especially given the default OAPI design from swagger having each endpoint in a collapsable section, so this would be the next best option I would say.

Quick mockup to show what I mean: grafik grafik

I understand if this is something not worth considering. Just felt like it would be good to have some option to reduce the vertical height of the generated page, as large APIs could create very large pages...