Tidy up

Break up walls of text into small sections. Bring old docs up to speed with newer ones.