filling out the documentation a little more thoroughly