readme: more details, update-gh-pages.sh