Update documentation in preparation for stable release

This PR includes changes following a holistic pass at the documentation.
+100 for removing the fiddly `pip install` directions.