Documentation tidy up and add appendix of returned objects