Update documentation in preparation for stable release

This PR includes changes following a holistic pass at the documentation.
We still see this pretty frequently, although since I added this we have fleshed out the Troubleshooting Deis docs. I still think it's helpful to call out here, though.