rewrite instructions building docs and uploading to website

Also include grammatical/stylistic changes, and a re-ordering
of some sections.