add REST documentation for discussions module

requires common models in PR https://github.com/oaeproject/Hilary/pull/924
I think they can remain arrays in the documentation. The Swagger UI still allows us to add a simple string in there, and hopefully updating Swagger UI will just make it support the array side of it.