Introduce tags hierarchy

[dtsaryov]

Hello.

My proposal is to add an ability to create tags hierarchy, for example:

tags:
  - name: Entites
    description: CRUD entities operations
      - User
      - Group
  - name: Services
    description: Predefined queries execution
      - FooService:
        - name: ...
          description: ...
      - BarService:
        - name: ...
          description:

It'll help to group operations in case of generic REST API.

[MikeRalphson]

See also #1367

[ymohdriz]

Hi @prozac631,

If I understood correctly, open api provides a way to tag in operation level. Hope we can group operations by using operation level tagging.
Let me know if your requirement is completely different.

Thanks,
Mohammed

[dtsaryov]

Hi @ymohdriz

Yes, we can use grouping for operations, but it would be nice if we could group operations inside of group of operations. Let me make it more clear.

For example, you have operations and their paths have the following template: /entities/* (entities/User, entities/Group, etc).

And in the same time you have a set operations that can be performed with these entities, for example: entities/User/create, entities/User/get, entities/User/delete, etc.

And in this case we can create a tag Entities and sub tags User, Group, etc.

[maaland]

I support the request for sub-tags. I want to be able to group (or at least sort) the methods under each of my endpoints, and as far as I can tell, that's not possible right now.

[silkentrance]

See also #1642. The path is already a physical group, why do you need an indirection for it? And as far as I understand it, you can add multiple tags to a given operation.

[jukeblimp32]

I really need subtags. My current tags are getting far too cluttered.

[ShangyanLi]

@jukeblimp32 not sure if this is helpful but have you looked into the x-tagGroups option in ReDoc vendor extensions?

[farmbotgianpaolo]

I support the request for sub-tags or tag hyerarchy. The reason is simple: if I have a single endpoint where I built public and private APIs I would like to group them into these 2 categories.

[storm367]

Tag Hierarchy doesn't seem to be supported yet? I support this request to add sub-tags.

[dschmide]

Adding sub-tags is ab obvious advantage. Remember, there is no search and filter option for the apidocs, so this tagging system is all we can provide to devs.
At this point, my co-workers are telling me to add subgroups, and not believing me when I tell them that "its not possible", but sadly, this is a reality.
I started embedding "tags" right in the paths so the structure within tags is at least somewhat preserved by abusing the alphabetical ordering - but this is clearly a symptom of a lack of feature.

[kael-shipman]

I support this, and furthermore support closing this issue as a duplicate of #1367 so that we can keep the conversation in one place. Adding my comments over there.

[handrews]

Closing as recommended as a duplicate of #1367 - please continue the conversation there!