Hacker News Reader

Accurate, appropriately detailed, and up-to-date documentation and references are about way, way more than "first impressions".

I really don't see how it's a hard problem either? How often does a payment gateway API really need to change? Just spend the resources necessary to get it right. If you really need to, hire (another) FTE on docs.

View on HN

Yes but you'll only know how good it really is once you try it

At first glance some docs look good but when you go to use it, it's confusing/incomplete/outdated

I don't think anyone argued that great docs are sufficient for a great API. They are a requirement, though.

I feel like stripe changed their api every day. They support legacy apis forever but you could definitely have a full time job keeping up with the latest version of stripe.

Reply on news.ycombinator.com