many documentation updates
add pypi directive
make link to https
use pypi rule
use epilog instead of prolog
remove now unused prolog
minor cleanup
common 'Next steps' chapter for installation instructions