Swagger

[cameronjacoby]

Better documentation with http://swagger.io

[eerwitt]

Added in an initial usage of Swagger on: https://github.com/sf-wdi-24/crud-api/compare/swagger

Most changes are on server.js but also added in swaggerui.

I set the model definition on GET /books/ to return an Object instead of an Array which is a common practice to support additional information about the result set.

Is it OK if we change the responses for the listing to be an object with an element for "results" or "books"?

While looking over it, I think if someone is first starting out seeing all this information is overwhelming!

[cameronjacoby]

Just recapping what @eerwitt and I talked about earlier. This is a really awesome start for getting us up and running with Swagger, but we won't finish implementing it for week 3, since the API is in a working state for our lessons, and we should focus on lesson planning instead.

It can be an ongoing effort to implement swagger, so we'll leave this issue and the branch open for now.