add comments to all preprocessing helpers