Add to README on running examples with pytest.
Reformat README as reStructuredText.
Merge pull request #1 from seanfisk/seanfisk/improve-readme

Improve the README.