Readme changes to address overlapping parameter issues

See #93
documentation fixes