fixes, finalized examples, docs