Merge pull request #1 from kmyr/readme-changes

Readme changes
work in progress
more docs and comments
beans table
work in progress
merged readme updates