update docs for methods that return a Promise as of 0.4.0