adding more comments to refactored parameters