add REST documentation for discussions module

requires common models in PR https://github.com/oaeproject/Hilary/pull/924
Something along the lines of `postDiscussionShare` would be better