added comments and notes