updated definition and comment for remainder of methods