add REST documentation for search module

Can this just not have an enumeration of possible values? e.g.

```
@Property  {User|Group|Discussion|Content[]}       results ...
```

Otherwise we're going to be documenting the properties of these shared entities in a ton of places and it's going to be a maintenance nightmare every time one of these models changes.