update readme with link to annotated source
fix issue in docs script
add script for publishing docs to gh-pages