Various doc updates

Instead of putting these in comments on your PR, I just made the updates myself ;)