Update documentation in preparation for stable release

This PR includes changes following a holistic pass at the documentation.
Ramona says you never capitalize tool names like `deisctl`, even if they're in headers or start a sentence. They're like proper nouns intended as lowercase--think `ls` and you'll probably agree.

No need to change this, just saying.