last minute polish

polishing code examples, fixing async, added docs