Why These API Docs are Better Than Yours (And What You Can Do About It) – Readme.io

The rise of API-first companies has put the emphasis on clear, user-friendly API documentation. Stripe, a company offering a suite of online payment APIs, quickly realized that their product's value hinged on people's ability to learn and understand how its API works. Thanks to Stripe and a few others, developers' expectations have changed. Now they expect thorough, navigable documentation presented in a clean, error-free UI. If you deliver anything less, few developers will even bother with your API. This article describes what it takes to make the cut.