#510 added resource and tidied up docs

First entry for API Resource documentation.
This link and the following 2 point to a non-existing page.