Books
- Coming soon...
Websites and Web articles
- Ten Essentials for Good API Documentation [A List Apart]
- Ten Extras for Great API Documentation [A List Apart]
- API Documentation using Swagger [Swagger.io]
- API Documentation Made Easy with OpenAPI & Swagger [Swagger.io]
- Documenting REST APIs using Confluence [Atlassian]
- Documenting your REST API [GitHub]
- Document your REST API with RAML [RAML]
- REST API documentation best practices [Bocoup]
- Maintainable API Docs and Other Rainbow Colored Unicorns [Neil Mansilla]
- API Documentation at Stoplight [Stoplight.io... has several other good references]
Courses
- Documenting APIs: A guide for technical writers [I'd Rather Be Writing]
- SDK Bridge offers online courses in learning the art of writing API documentation
- Here's a list of courses taught by Peter Gruenbaum on Udemy:
- API Doc: Basic Programming
- Learn API Tech Writing 2: REST for Writers
- The Art of API Documentation (API Doc 3)
- Learn API Technical Writing: JSON and XML for Writers
- Learn Swagger and the Open API Spec
- Git and GitHub for Writers
Tools
- A long and annotated list of Free and Open Source API Documentation Tools [Pronovix]
Tools that are not language-specific
Tools for documenting APIs written in Java
Tools for documenting APIs written in PHP
Tools for documenting APIs written in Rails/Ruby
- Apipie-rails
- Rapidoc
- YARD — "Yay A Ruby Documentation" tool
Link to Yardoc plugin