add comments and update formatting of parameters