Update of Documentation
This MR contains the refurbished updates to the manual prepared by @williamm and finished by me.
More documentation to come - I'm not sure if we should leave this as WIP
until we have at least removed all todo
markers from the PDF.