update docs to be more helpful during setup

issue #1382 (closed)

this PR resolves the issue by adding help text to the setup document. I also took the opportunity to clean up the Markdown and add some wisdom of my own.