Added nearly-complete documentation to README

Still missing docs for convenience functions "fulfilled" and "rejected".