Cooperation between you and Typedapi about typed-schema

[Odomontois]

Hi.
Yeah, I have definitely heard about your awesome project and would gladly cooperate.

My project is about 1.5 year old. It was an internal Tinkoff bank project. I intented to publish it from the very start, but it is not so easy in the bank business.
I have published it without the history to hide sensitive informarion, so it misses previous 225 commits 😀

[pheymann]

Hi @Odomontois ,
I realized you support swagger generation. There are also plans to add it to my lib but I haven't found a (satisfying) solution for the following problem:

How to add comments?

I mean, it is "simple" enough to generate the basic documentation from the type/value information available, but what I found crucial is to have comments. Otherwise, it is hard for people to really understand what is happening.

Did you find a way to incorporate comments into your (did see it so far but maybe I missed it) without cluttering the api declaration? I still haven't found a satisfying way.

[Odomontois]

Hi. Sorry for the late answer. Haven't been fully integrated OSS into my life
I have couple of distinct solutions here.
First are implicits with default arguments like here

https://github.com/TinkoffCreditSystems/typed-schema/blob/master/src/main/scala/ru/tinkoff/tschema/swagger/SwaggerTypeable.scala#L212

and here

https://github.com/TinkoffCreditSystems/typed-schema/blob/master/src/main/scala/ru/tinkoff/tschema/swagger/SwaggerTypeable.scala#L269

Second one, more like runtime one - injecting definitions from .properties bundles created like that https://github.com/TinkoffCreditSystems/typed-schema/blob/master/src/main/scala/ru/tinkoff/tschema/swagger/PathDescription.scala

Here the example of injecting https://github.com/TinkoffCreditSystems/typed-schema/blob/master/examples/src/main/scala/ru/tinkoff/tschema/examples/TestServer.scala#L22

And here is examples of .property file
https://github.com/TinkoffCreditSystems/typed-schema/tree/master/examples/src/main/resources