Hei Hei. I am wondering if Ktor team has conclud...

# ktor

[Satyam Agarwal]

Hei Hei.

I am wondering if Ktor team has concluded something regarding open api doc generation/ swagger support so far ?
Would be super interesting to hear if you have thought about how this will be supported in the framework or the project attached in the swagger youtrack ticket will be adopted as is ?

It was mentioned in the roadmap https://blog.jetbrains.com/ktor/2022/02/11/ktor-roadmap-what-s-next/

[simon.vergauwen]

Additional question, is it somehow going to be related to Type Safe Routes?

I've been looking at them as a point for OpenAPI integration for building library, but then @Satyam Agarwal shared it's on the current roadmap.

[Satyam Agarwal]

@Aleksei Tirman [JB]

[Tim Abil]

could take a look at https://github.com/tabilzad/ktor-docs-plugin

[Aleksei Tirman [JB]]

We have plans to implement OpenAPI specification generation for Ktor applications via a plugin in IDEA.

[simon.vergauwen]

@Aleksei Tirman [JB] so there will be no ways to give any guarantees about the OpenAPI docs at build-time? It will be a manual task from IDEA to generate it?

[simon.vergauwen]

@Tim Abil am I seeing it correctly that the linked library does not generate any documentation for receive or respond?

[Tim Abil]

Response schemas aren't supported yet but request should be generated if enableRequestSchemas feature flag is set.

[Aleksei Tirman [JB]]

@simon.vergauwen we didn’t start implementing it yet so I cannot provide such details.

[simon.vergauwen]

Thanks for letting me know @Aleksei Tirman [JB]. Very much looking forward to seeing this take shape! Not sure if I can share any thoughts, or feedback on the feature but a big requirement for most projects where I needed this was the build-time guarantee that the doc and API are aligned. So as long as CI can guarantee something like that that'd be great. Even if it works in a similar style to KnitX where it compares output would be fine.