Partial documentation review for Lasse

Documentation review done directly in rest. Just focusing on content and not rendering at this stage. Lets try and cover as much as possible of this on Thursday? /benc