[WIP] Documentation updates

Tidying things up, and also will be adding some additional information based on reviewer feedback