Improve documentation

Some people stayed behind in Amsterdam and worked on the documentation ;-)