Documentation tidy up and add appendix of returned objects
Merge pull request #2 from Junction6/Damien_API_AJ-269

Documentation tidy up and add appendix of returned objects