code comments & readme update