adding comments about notification code logic