improve README and code_examples