closes #48 code comments
27 files changed