tidies up docs
minor changes to docs
makes large changes to get docs to build