clarify language in readme
add/improve comments