swagger-koa

swagger-koa copied to clipboard

**TL;DR:** `koa-render` and `jade` packages are missing for the example to run **How to reproduce:** When trying to run the example following instructions after `npm install` `node --harmony app.js` user...

mhaberl

Add the ability to use Swagger 2 specification

6

I add the ability to use Swagger 2 while keeping compatibility with existing Swagger1. Read README.md to see how to use.

vbuzzano

We were earlier using express and using jsdoc-express-with-swagger and using the jsdoc format and were able to reference definitions and tags as well as provide the response object. When we switched to koa that jsdoc did not work.

2

This is the jsdoc we used with express ``` /** - @swagger - /portfolio-company/{id}: - get: - description: Gets the portfolio company by identifier - tags: - - portfolio-company -...

alkasdj

I tried the example and is working fine. But its not validating request and response JSON schema. Could you please let me know how to do it. thanks

karthikzeta

Very nice project. If I understand correctly, you write your API specs as jsdoc comments. This middleware will read them and populate a swagger frontend for you, allowing you to...

jonahx