Definitive and Totally Up-To-Date API Docs

Thanks for this effort, Cyaga! You're correct - as the API grows, we'll definitely be making a concerted effort to produce detailed documentation and examples - but in the end, this project is for the community, so having you all contribute will make the API more successful :)

Going to sticky this post.

I'm going to unsticky this thread in favor of the documentation that will be released soon.