Readme improvements

documentation for recipe discussed in #45, and a smattering of other changes.

let me know if you don't like the other changes or have feedback on any wording.