Readme fixes

[jzohrab]

These are all trivial changes. I can squash them to a single commit if preferred.

[chef-supermarket]

Hi. I am an automated pull request bot named Curry. There are commits in this pull request whose authors are not yet authorized to contribute to Chef Software, Inc. projects or are using a non-GitHub verified email address. To become authorized to contribute, you will need to sign the Contributor License Agreement (CLA) as an individual or on behalf of your company. You can read more on Chef's blog.

Non-GitHub Verified Committers

There are 1 commit author(s) whose commits are authored by a non-GitHub verified email address. Chef will have to manually verify that they are authorized to contribute.

Please sign the CLA here.

[chef-supermarket]

Hi. Your friendly Curry bot here. Just letting you know that all commit authors have become authorized to contribute. I have added the "Signed CLA" label to this issue so it can easily be found in the future.

[chris-rock]

@jzohrab thank you very much for improving our documentation. Could you please rebase to latest master, I merge it then right now

[jzohrab]

@chris-rock: Check, rebasing and will re-push in a sec.

[jzohrab]

@chris-rock - Done, repushed -f.

[chris-rock]

@jzohrab thanks a lot!