add docblocks for the private methods