added notes and comments