Reducing docs

This PR addresses #481. I've left it as two commits for now. The first changes the example code in section 4.1 of the userguide so it uses a sample data file that actually exists. The second commit changes some of the code examples in this section so that they are subject to testing via ```make doctest```.