feature: add swagger documentation for API with auto-generated API docs

[niftylettuce]

for example:

/*
 * @api [get] /pets
 * description: "Returns all pets from the system that the user has access to"
 * responses:
 *   "200":
 *     description: "A list of pets."
 *     schema:
 *       type: "String"
 */

api.route('/pets', function() {
    /* Pet code 😺 */
});

so we comment out our API in and then run swagger-inline and then run swagger-to-slate and swagger-codegen.

References

• https://github.com/readmeio/swagger-inline
• https://github.com/lavkumarv/swagger-to-slate
• https://github.com/swagger-api/swagger-codegen

[OmgImAlexis]

Waiting on wcandillon/swagger-js-codegen#190