4 ms·

This is spot on. And the converse is also true. There is no faster way to lose me as a customer than a shoddy documentation. No matter how great rest of the mat

• tgsovlerkhgsel 5y ago
  > easy to try examples and a sandbox environment. This. The best marketing tool you can have is an "API explorer" style documentation where each call's documentation page comes with a built-in form to fill out and make an API call and see the response. Note that it has to actually work. If one of the form fields is "API key", you've squandered most of the potential. If the procedure to get an API key involves more than entering an e-mail address (which will be @mailinator.com, because I don't want to have your sales pitches cling to me if I decide the API doesn't meet my needs), I'll have to be very desperate to bother. If the procedure to get one involves talking a human (which often means "in a different time zone" or "not awake at the time I'm hacking on my project"), that means "you will definitely not be able to try this out within the next hour". Since I'm trying to solve something now not in a week, if there are competitors that don't create these hurdles, I'm going to go with them. If I can solve the problem by either waiting 8 hours for you to come online or write code for 4 hours and no longer need your API, I might choose the latter, because I want this solved now.
• Saris 5y ago
  What's crazy is how many I come across that don't even have a single screenshot of their products UI.