added more information to the comments based on feedback