Fix up some thinko's in the writing code and expand the README.md a tiny bit