add some informative code comments