I Love APIs 2015: Create Design-driven APIs with Node.js and Swagger

This document discusses API documentation and the use of Swagger to define APIs. It notes that API documentation is critical for others to understand what an API does. Good documentation includes examples and tutorials in addition to reference documentation. The document then introduces Swagger as a way to define APIs in JSON or YAML, describing available operations, inputs, outputs, authentication, and more. It discusses using Swagger both by generating code from Swagger definitions or by driving the code implementation from the Swagger specification. The document argues that starting with Swagger specifications can avoid duplication and better support code generation and documentation. It provides an example of defining a Node.js API using the Swagger tooling.