Added API documentation to resource data attributes and request params.
Now documenting examples for resource collections.
Cleaned up and documented some of the Resource API documentation plugin code.
Filled out the documentation on enumerate resource operations.

Also reworked the base operation method docs to make it easier to re-use
for other operations.
Now documenting related resource operations with YARD `@see` tags.
Added docs and examples for resource operations that return other resources.