Lessons From Training 1400+ People in Web API Design
For the last 2 years, Keith Casey and I have been conducted API training workshops with over 1400 participants across nearly a dozen roles. While we are stil...
Recent Posts
Building Your API Documentation Strategy For SUCCESS
So far, we have put together a foundation for our API documentation: 1. We must first move beyond API reference documentation and look for other ways to comm...
10 Questions Your API Documentation Must Answer
Effective communication is the most important factor for API success. APIs do not have a user interface, so your documentation is the primary communication m...
Improving Your API Conversations with Hypermedia, ETags, and Real-Time APIs
There is considerable source material on great API design. We can read discussions on how to use HTTP properly, from selecting the proper HTTP verb to which ...
Moving Beyond API Reference Documentation
“Great API documentation is essential” many people exclaim. So, you fire up your favorite API definition editor and start writing docs. You learn...