Add install section to README
Rework README to be more readable

In the design decisions for the previous version of the README executing
the doctests played a major role. Now that there are unit tests, the
README can (and should!) be used for demonstration rather than testing.
This makes the examples easier to read.
Merge branch 'improve-readme'