Document owner | |
|---|---|
Designer | |
Tech lead | |
Technical writers | |
QA | |
OKR | Continue to add high priority business improvements for enterprise customers. |
Request (CR) | |
Request (other) | |
Design Spec | |
Technical Spec | |
Test Plan |
Objective
Group objects (whether native or AD/LDAP) are valuable as referenced objects in communication. Groups of people, whether departments, roles, owners, etc. can be needed in a discussion or channel for collaboration purposes. This feature aims to provide that value.
Background
Groups exists within AD/LDAP sync and will soon become an independent feature. Referencing these groups of users is demanded and expected by MM users and administrators.
There is also currently a plugin that was built to accomplish some of the scenarios:
https://github.com/mattermost/mattermost-plugin-autolink
Success metrics
Goal | Metric |
|---|---|
Build a useful feature that enables messaging and inviting groups of users with a single command |
|
User Scenarios
Members (not guests) of any channel can @mention groups of users (e.g. @infosec or @finance)
Members (not guests) can /invite any of those same groups
Members want to mention users in a specific channel that are also in a specific group
Admins can choose which groups are available to be referenced
Members can manage notifications for groups mentions (TBD)
Admins can restrict disabling of notifications (TBD)
Assumptions
Phases & Milestones
Areas Touched
Permissions
System Console UI (Channel Configuration page and permissions)
Chat-facing UI
Groups
Desktop/Mobile Apps
Requirements
Requirement | User Story | Importance | Jira Issue | |
|---|---|---|---|---|
| 1 | Allow members to /invite groups by their group name | As a user, I want the ability to add or invite entire groups to a channel | HIGH | |
| 2 | Allow members to @mention groups by their group name | As a user, I want the ability to @mention entire groups and push a notification to that group | HIGH | |
| 3 | Add group names to autocomplete suggestions on invite and mention screens | As a user, I want automated suggestions for groups as a type so that I can more easily find the group I am looking to reference | MEDIUM | |
| 4 | Ability for admins to turn off @mentions for specified groups | As an admin, I want the ability to toggle the above setting on and off for each group | MEDIUM | |
| 5 | Ability for users to mute or turn off notifications from group mentions (TBD) | As a user, I want the ability to turn off notifications for group-referenced notifications | LOW | |
| 6 | Ability for admins to restrict disabling of notifications for specific groups (TBD) | As an admin, I want the ability to restrict the ability to turn off notifications for specific groups | LOW |
Open Questions
Question | Answer | Date Answered |
|---|---|---|
Does it make sense to allow role @mentions or invites? Such as @system admin or @moderator, etc? | ||
How do we prevent disruptive invitations to a channel when attempting to mention users? |
Risks
disruptive invitations to a channel when attempting to mention users
security issue if we reveal users in specific groups
Out of Scope
secret groups - groups that can be mentioned only and if no one from the group is in the channel, nothing happens (potentially with preview before joining)