Small fixes to Promise documentation 

Also, use fail() instead of catch() for RSVP.Promises.