add REST documentation for discussions module

requires common models in PR https://github.com/oaeproject/Hilary/pull/924
I'll fix them up as I go through this. If there is any follow-up required, it can be dealt with as part of the follow up PR