improve examples, docs