Update the documentation.

[bas-rustenburg]

The documentation is out of date. Some examples would now work differently, and some code has been deprecated/removed.
We should add new documentation and new examples before releasing

[bas-rustenburg]

One of the things that will need to be paid attention to are the paths in the configuration of the documentation so that references to different classes work again. Additionally, many sections will need to be rewritten.