addition of more comments about the program functionality and observations