Readme Driven API changes

pinging @kenichi @davy @jwieringa @brooksjbr @poeks for input on this new API
In this line `analysis` is going to be `nil` -- I'm assuming we will also need a way to replace the `@online.item_analyze` method? 

`item.analyze(...)`?