Updating docs in preparation for 1.0.10

Cleaning up this branch which looks like it has some valid improvements