shorten comments to decrease validation errors