Update README for 1.0.0 changes

Closes #74
perhaps `... for display to the user` ? (what you have is OK too)