cleanup of how to document methods