closes #48 code comments