readme remove deprecation, add image
move example to separate doc page
Merge pull request #610 from modilabs/readme-cleanup

Readme cleanup