update code comments for accuracy & succinctness