Implement response “presets” that allow developers to manage and create custom valid responses and descriptions during swagger configuration. These presets could then be invoked by attaching a single attribute to a method.
In addition, response descriptions could also be preset. I understand that descriptions can be built using the xml tag. I am suggesting that this feature could allow for general custom responses written by the developer - once - to apply globally through the simple addition of an attribute.
I have attached a file below depicting a typical use case.
I would also love to have support for ApiConventionType and ApiConventionMethod attributes added to swashbuckle. They make the code so much more readable.
Implement response “presets” that allow developers to manage and create custom valid responses and descriptions during swagger configuration. These presets could then be invoked by attaching a single attribute to a method.
This is partly influenced by Microsoft's addition of API Conventions referenced in: https://docs.microsoft.com/en-us/aspnet/core/web-api/advanced/conventions?view=aspnetcore-2.2
In addition, response descriptions could also be preset. I understand that descriptions can be built using the xml tag. I am suggesting that this feature could allow for general custom responses written by the developer - once - to apply globally through the simple addition of an attribute.
I have attached a file below depicting a typical use case.
IdealApiConvention.txt