Swagger uses json schema. If you want to get free documentation it makes sense to use json schema and quickly put together a swagger description of your api to

Swagger uses json schema. If you want to get free documentation it makes sense to use json schema and quickly put together a swagger description of your api to get free docs for your api. You will also get a lot of good tooling around your api