doc refresh

update README, including to do.