Add info on usage of Promises
Add examples for Promises documentation
Make examples for Promises slightly more consistent
Small fixes to Promise documentation 

Also, use fail() instead of catch() for RSVP.Promises.
Merge pull request #1 from coconut-ogd/add-info-on-promises

Add info on usage of Promises