OpenAPI tags seem to be not working in 3.3.0, is a...

# ktor

[Fedor Erofeev]

OpenAPI tags seem to be not working in 3.3.0, is anyone facing this issue? Update: have to specify it as e.g. @tag users if someone having troubles, seems KLIP has some wrong sample

[Hristijan]

https://youtrack.jetbrains.com/issue/KTOR-8942/StackOverflowError-using-buildOpenApi

[Aleksei Tirman [JB]]

@Fedor Erofeev, do you mean the tags specified in KDocs are ignored?

[Fedor Erofeev]

@Aleksei Tirman [JB] They work, but not as per documentation/example: https://ktor.io/docs/openapi-spec-generation.html#supported-kdoc-fields
KLIP example has param defined as `@tags`:

routing {
     /**
      * Get a list of widgets
      * 
      * @tags widgets
      */
     get("/widgets/{id}") {
         ... 
     }
 }

What works is defining it as @tag :

routing {
     /**
      * Get a list of widgets
      * 
      * @tag widgets
      */
     get("/widgets/{id}") {
         ... 
     }
 }

I think there is some mixup in the docs on the way to define tags 🙂 I'm using Ktor 3.3.0

[Bruce Hamilton]

yes, it ended up being @tag, we'll need to update the docs 😞

[Fedor Erofeev]

@Bruce Hamilton Thank you! Will report if I come across any other issues, so far it's pretty good! (didn't get the issue mentioned above with StackOverflow) 🙂