Add support for OAS 3.2 Nested Tags

[artsiommiksiuk]

Clear and concise description of the problem

According to OAS 3.2 spec tags now can have parent field, allowing to create tags hierarchy.

https://spec.openapis.org/oas/v3.2.0.html#tag-object

I couldn't find any documentation around it and seems like it wasn't yet implemented.

I'm proposing to to extend default @tag decorator to accept now variadic amount of strings.

@tag("parent1", "parent2", "actual-tag")
op myop(): void

In this case all strings will represent hierarchy path.

Checklist

• Follow our Code of Conduct
• Read the docs.
• Check that there isn't already an issue that request the same feature to avoid creating a duplicate.

[timotheeguerin]

that might more be part of the @tagMetadata

Like this but without the x-
playground

@service
@tagMetadata("pet", #{
  description: "Pet"
})
@tagMetadata("cat", #{
  description: "Cat",
  `x-parent`: "pet",
})
namespace My;

@tag("cat")
op test(): string;

[artsiommiksiuk]

Ah, yeah, you right. This makes sense.

[timotheeguerin]

Oh I wouldn't say it's done, we still need to allow putting parent directly without x-. And what does that mean for 3.1 and 3.0. One option is to add the x- if someone try to use it but emit 3.0 or 3.1

[artsiommiksiuk]

@timotheeguerin alrighty, you know it better from here. 🙂