improving readme.md docs and examples