added some code comments for madison