added some new code comments