Add support for Tags and Tag Grouping of Paths?

[kevinawoo]

Swagger supports grouping paths via tags https://swagger.io/docs/specification/grouping-operations-with-tags/.

This request is to ask for support for add tag groups as markdown header groupings.

An example output would be something like:

# My Awesome API
## Version 2.0
### Security
security stuff...

### Dogs
These endpoints are dog related endpoints.

#### /list
##### Get
###### Summary
Get all available dogs
###### Description
We'll give a list of all the dogs in the world, paged of course

### Cats
These endpoints are cats related endpoints.

#### /list
##### Get
###### Summary
Get all available cats
###### Description
We'll give a list of all the cats in the world, paged of course

This proposed solution would require that:

• Swagger paths will need to be grouped by tags (adding 1 layer of nesting)
• When there's no tag grouping, do current behavior (aka, no nesting)

[syroegkin]

This is indeed a very nice feature. I'll take care of it and it shall be included in the v2.0 release.

[syroegkin]

:tada: This issue has been resolved in version 2.0.0-beta.13 :tada:

The release is available on:

• npm package (@beta dist-tag)
• GitHub release

Your semantic-release bot :package::rocket:

[syroegkin]

:tada: This issue has been resolved in version 2.0.0 :tada:

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot :package::rocket: