updated some code comments