Extensive OpenAPI / Swagger resource guide (blog.runscope.com)

"We broke down this guide into the following topics: Writing Spec / Design, Documentation, Generators, Servers, Clients, Testing & Monitoring, Gateways / Management, Public Specifications"