Describe first

Give the reader the complete context *before* showing the example code.
Merge pull request #5 from gjhiggins/master

Minor doc change