add REST documentation for discussions module

requires common models in PR https://github.com/oaeproject/Hilary/pull/924
If we're going to distinguish between full entity profiles and basic entity profiles, the type should be `BasicDiscussion` here.