fixed up the documentation a bit