docs(ngResource): clarify behaviour of $promise