updated readme

Readme updates

README tweaks

Readme

add a note on usage of the "refresh" attribute

closing ticks
Merge pull request #52 from Shopify/documentation

Updated documentation