add REST documentation for discussions module

requires common models in PR https://github.com/oaeproject/Hilary/pull/924
This should have been `PathParam`