docs, examples, minor fixes