Versions Compared

Version Old Version 13 New Version 14
Changes made by

Dennis Kittrell (Deactivated)

Dennis Kittrell (Deactivated)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Document owner

Dennis Kittrell (Deactivated)

Designer

Michael Gamble (Deactivated)

Tech lead

Scott Bishel

Technical writers

Justine Geffen (Deactivated)

QA

Rohitesh Gupta (Deactivated)

OKR

Continue to add high priority business improvements for enterprise customers.

Request (CR)

https://mattermost.atlassian.net/browse/CR-4

Request (other)

Design Spec

Design Spec - Group Reference Objects

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.

...

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

  • 100% of customers who requested this feature confirm that this is what they want

  • 75% of MM customers with telemetry have at least some daily references to group objects

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

Roadmap Planner
maplinks
timelinetrue
pagelinks
source%7B%22title%22%3A%22Roadmap%20Planner%22%2C%22timeline%22%3A%7B%22startDate%22%3A%222020-01-15%2000%3A00%3A00%22%2C%22endDate%22%3A%222020-06-01%2000%3A00%3A00%22%2C%22displayOption%22%3A%22MONTH%22%7D%2C%22lanes%22%3A%5B%7B%22title%22%3A%22Design%22%2C%22color%22%3A%7B%22lane%22%3A%22%23f6c342%22%2C%22bar%22%3A%22%23fadb8e%22%2C%22text%22%3A%22%23594300%22%2C%22count%22%3A1%7D%2C%22bars%22%3A%5B%7B%22rowIndex%22%3A0%2C%22startDate%22%3A%222020-02-04%2017%3A35%3A02%22%2C%22id%22%3A%22ab2a7613-06e4-44e8-ab2a-b28bccb9f48e%22%2C%22title%22%3A%22UX%20Review%22%2C%22description%22%3A%22%22%2C%22duration%22%3A0.6633663366336634%2C%22pageLink%22%3A%7B%7D%7D%5D%7D%2C%7B%22title%22%3A%22Develop%22%2C%22color%22%3A%7B%22lane%22%3A%22%233b7fc4%22%2C%22bar%22%3A%22%236c9fd3%22%2C%22text%22%3A%22%23ffffff%22%2C%22count%22%3A1%7D%2C%22bars%22%3A%5B%7B%22title%22%3A%22iOS%20App%22%2C%22description%22%3A%22This%20is%20the%20third%20bar.%22%2C%22startDate%22%3A%222018-07-13%2021%3A23%3A10%22%2C%22duration%22%3A2.5%2C%22rowIndex%22%3A1%2C%22id%22%3A%22dd93afcd-2704-4253-adb8-809a336cc5ba%22%2C%22pageLink%22%3A%7B%7D%7D%2C%7B%22rowIndex%22%3A1%2C%22startDate%22%3A%222018-10-10%2004%3A59%3A24%22%2C%22id%22%3A%228dc8bc2d-b7cb-44a8-b526-7d1ede51f690%22%2C%22title%22%3A%22Android%22%2C%22description%22%3A%22%22%2C%22duration%22%3A2.4752475247524752%2C%22pageLink%22%3A%7B%7D%7D%2C%7B%22rowIndex%22%3A0%2C%22startDate%22%3A%222020-02-15%2008%3A33%3A16%22%2C%22id%22%3A%22385b2ac7-b90d-49c4-ab8b-45c3c88ac67c%22%2C%22title%22%3A%22Development%22%2C%22description%22%3A%22%22%2C%22duration%22%3A1%2C%22pageLink%22%3A%7B%7D%7D%2C%7B%22rowIndex%22%3A1%2C%22startDate%22%3A%222020-02-29%2003%3A19%3A36%22%2C%22id%22%3A%22ad1e8c38-fbbd-4a72-b353-45c6d4e65ab6%22%2C%22title%22%3A%22QA%22%2C%22description%22%3A%22%22%2C%22duration%22%3A1%2C%22pageLink%22%3A%7B%7D%7D%2C%7B%22rowIndex%22%3A2%2C%22startDate%22%3A%222020-03-04%2023%3A45%3A44%22%2C%22id%22%3A%227d538304-7206-49ff-9c99-bcc52d33c95c%22%2C%22title%22%3A%22Documentation%22%2C%22description%22%3A%22%22%2C%22duration%22%3A1.118811881188119%2C%22pageLink%22%3A%7B%7D%7D%5D%7D%5D%2C%22markers%22%3A%5B%7B%22title%22%3A%22Milestone%201%22%2C%22markerDate%22%3A%222018-07-31%2016%3A38%3A01%22%7D%2C%7B%22markerDate%22%3A%222018-10-08%2001%3A25%3A32%22%2C%22title%22%3A%22Go%2FNo%20go%22%7D%2C%7B%22markerDate%22%3A%222018-12-31%2001%3A54%3A03%22%2C%22title%22%3A%22Milestone%202%22%7D%2C%7B%22markerDate%22%3A%222020-03-16%2015%3A40%3A59%22%2C%22title%22%3A%225.22%20CF%22%7D%2C%7B%22markerDate%22%3A%222020-01-16%2008%3A19%3A00%22%2C%22title%22%3A%225.20%20CF%22%7D%2C%7B%22markerDate%22%3A%222020-05-16%2000%3A57%3A01%22%2C%22title%22%3A%225.24%20CF%22%7D%5D%7D
titleRoadmap%20Planner
hashaa0ccf96138d83c7ad7448f911135d55

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

Status
colourRed
titleHIGH

https://mattermost.atlassian.net/browse/MM-22445

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

Status
colourRed
titleHIGH

https://mattermost.atlassian.net/browse/MM-22446

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

Status
colourYellow
titleMEDIUM

https://mattermost.atlassian.net/browse/MM-22447

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

Status
colourYellow
titleMEDIUM

 https://mattermost.atlassian.net/browse/MM-22448

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

Status
colourGreen
titleLOW

https://mattermost.atlassian.net/browse/MM-22449

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

Status
colourGreen
titleLOW

https://mattermost.atlassian.net/browse/MM-22451

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

  • TBD