fleshing out the gh-pages document