initial readme
Finish README.md; update code to match
Merge branch 'readme-work-in-progress'