Update some of the exsisting documentation texts and add subsections.