readme clarifications and updated examples
new readme for examples folder. might be moved to wiki laters
cleaned up helpers documentation, improved formatting
better markdown docs
Merge remote-tracking branch 'refs/remotes/origin/master'