This explains it a bit more based on end user feedback. We also fix the example, which was wrong. Fixes #82.