Update documentation in preparation for stable release

This PR includes changes following a holistic pass at the documentation.
I think this should end with a period and be a complete sentence.

Also we should say Deis shouldn't be used to run a nuclear facility.