Some more notes on the reference
Some general improvements to the documentation