[WIP] Doc updates

- do not merge, still playing with stuff.

also see http://burnman.org/BurnMan.pdf