Update the docs for 3.0!

This PR addresses very outdated docs and PR: #3107, possible more.