another pretty large sweep of the main docs