updated files with comments