#164 bug fix, progress on readme