created bean to serialize
modified some names and body of responses
added some properties, improved responses to better match an APISpark contract
removed useless class subResource
changed structure, added documentation root node
added link between doc and contract