adding improved comments