[2.3] some changes to RestControllerGenerator

- Don't wrap returned objects in array: The methods that return single objects (get[Entity]Action, post[Entity]Action, put[Entity]Action) now return the entity directly instead of an Array containing the object

- fix some doc comments