Readme fixes

These changes fix the portions of issue #1 that were because of issues in the readme, and also additional unrelated changes to the readme that seem like good ideas to me.