Updates to the docs.
Random changes, some from code review some cleanup.