Better promises examples in the README, where by "better" I mean not horribly wrong.