Feature: split definitions to several swagger.json

[HT-Xaris]

Describe the issue We have several azure functions that are used for different applications. In order to offer a reduced definition to each consumer, we would like to be able to group the functions and generate a separate document per group. There are already the tags and it would be cool to be able to enable that one document is generated per tag.

Alternatively, we'd like to have a separate property that can be used explicitly for this and allow a function to be transferred to multiple documents.

Expected behavior

• There is a possibility to activate multiple documents (swagger.json).
• There is a property that determines which function is included in which document.
• A function can be included in 1 or more documents.
• Startingpoint: https://github.com/domaindrivendev/Swashbuckle.AspNetCore#generate-multiple-swagger-documents

[verdantburrito]

@HT-Xaris Redocly CLI is open-source & can do this. Seems like you'd get the results you want by using that tool. There are probably other tools out there that can do the same job; this is just the first one that I thought of.