merging data api updates from yo-pinz branch into master
cleaning up random example

Cleaning up random example to have more meaningful examples and
generate observables from metadata document.
cleaning up post examples
Update README.md
merge with master