Ask HN: Why is Stripe API documentation lacking so badly?

I really enjoy working with all parts of Stripe, except for reading their API documentation because it is lacking so much.