updated readme

Readme updates

README tweaks

Readme

add a note on usage of the "refresh" attribute

closing ticks