readme, examples, fixes