some minor things
update readme
update doc
move cache clear
comments in docs