Update docs

I've added some documentation which I found was missing.

Can someone please prof read it :) e.g. @petya2164 or @mortenvp?