Updates to documentation to add clarity and fill in gaps.

[greenaar]

I have attempted to keep the format relatively consistent, and I've added items I found helpful to know in hindsight.

Please feel free to review this and suggest/make any edits you feel appropriate.