GetResourceList standardisation, GetResource salization

Removes "/resources/" prefix and ".{format}" suffix from the getResourceList() returned resource paths. This allows Swagger to use data from getResourceList as an index of available resources, and auto-crawl the list successfully.

For comparison, see the demo index: http://petstore.swagger.wordnik.com/api/api-docs
This refers to the resourced http://petstore.swagger.wordnik.com/api/api-docs/users which is auto-crawled as a result.

--

Also adds usage of the $serialize argument in getResource() to return the resource rather than the JSON document. Useful for frameworks that want to encode their own documents.