update code comments, more verbose