clean up documentation
more documentation updates, re-roxygenize