readme changes, fixes #1

for code review