3 ms·
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 h
by 3np 4y ago
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.
- spinlock 4y agoI 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.
- raverbashing 4y agoYes 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
- 3np 4y agoI don't think anyone argued that great docs are sufficient for a great API. They are a requirement, though.