updated files with additional comments