update code comments
update notes