added comments and @params details