Adding readme for example
Updating documentation and incorporating Jakob's notes.
Merge pull request #1 from pete-the-pete/master

Adding readme for example