updated docs, examples, readme