mega tidy-up of the docs