Added new documentation w/ doctests. Confirmed problem in Model.simulate_experiment.

The new documentation uses doctests [http://sphinx-doc.org/ext/doctest.html]
to test that implementations are correct. These tests have revealed
a problem with simulate_experiment that only manifests if multiple
expparams are passed at once. Since this will be needed for future
ABC work, we should look at that in more detail soon.