Feature: Resources should describe results better

[skeddles]

https://docs.patreon.com/#resources just has a list of what will be returned, but doesn't say what they all mean.

For example, the different between pledge.pledge_cap_cents and pledge.amount_cents.

I've been having a hard time figure out how to do basic things with your API.

It could also use some example for common things, ie get users current pledge of your campaign.

Also figuring out what API version to use or which one the docs are talking about is confusing, you separate them into two completely different docs, and not act like everyone already knows how to use apiv1.