Add a few important comments to averaging code