Update documentation in preparation for stable release

This PR includes changes following a holistic pass at the documentation.
This should link to _`easy-fix` i assume