updating these files with comments