added comments to partial function