add some comments / user feedback