Docs cleanup

More to come. Posting already to get feedback on wording/certain changes.
@cvrebert Mind handing me the eloquence for one second here?