added comments to describe expected arguments