improved code comments