add examples sphinx page
fix docstrings in two examples
example headers
Merge pull request #1 from tjhei/examples_in_doc

Examples in doc
Lots of reworking input structure
Move benchmark file into tests.  Not really sure where the best place for this is, but I don't think it's in the burnman directory
Forgot these changes