Adding path level tagging

[ymohdriz]

Hi team,

Currently OAS supports tagging in API and operation level. This PR is to add tagging in path level also.
Related feature request related to this:
#1367

Please review the PR and merge the same.

Thanks,
Mohammed

[darrelmiller]

Hey @ymohdriz Thanks for the PR. This is definitely an interesting addition that has a low impact on the spec. However, we do have to consider the impact on tooling. We would need to get feedback from folks who are producing documentation based on OpenAPI as to whether they have user requests for these features and whether they are prepared to do the work to incorporate this capability.

Also, this kind of change cannot go into a patch release, it would need to go into a 3.1 branch which I don't believe we have yet created because we are still working on what features will go into 3.1.

We will definitely consider this for inclusion and the more feedback we can get from tooling people on this, the easier it will be to make the call.

[ymohdriz]

Hi @darrelmiller,

Thanks for the detailed response.
I would like to contribute to this project. But new PRs may turn into new features.
Can you please suggest some areas to work on?

Thanks,
Mohammed

[emreakca]

Hey @darrelmiller,

What's the state? Are subtags considered to be a feature, because it would be great!
If it's possible, a push would be very helpful!

[MikeRalphson]

This PR cannot be accepted as-is, because a) it is targeted at v2.0 of the specification, which is published and will not change, b) it only updates the schema file, which is not the source-of-truth of the specification (the markdown documents are), c) as @darrelmiller says, this change (if accepted) would need to go into a minor release, such as v3.1.0

@emreakca if you need sub-tag grouping / a hierarchy of tags, it would probably be worth commenting on #1367 or #1507 as appropriate.

[MikeRalphson]

Closing, for the reasons given in #1509 (comment)