improvements to logging; working on readme [see #2]