fill in some more useful docblocks