update REST documentation for discussions module

I actually like `DiscussionMembersUpdate` better than the consolidated `Permissions` model. It describes more accurately what's going on, and it allows us to specify the roles that are specific to the entity for which the update is being done.

I'd be in favor of having `ContentMembersUpdate`, etc. elsewhere