Update readme.md

Lots of docs and examples added.