Notification expectations (#7440)

* Initial commit to build new info architecture outline

* Drafted web, desktop, & mobile notification details

* Channel-specific & reply-thread prod expectations

* Final notification section updates

* Final notifications updates

* Incorporated reviewer feedback

* Incorporated reviewer feedback

* Incorporated reviewer feedback

* screenshot update

---------

Co-authored-by: M-ZubairAhmed <[email protected]>

source/preferences/manage-your-desktop-notifications.rst

@@ -17,17 +17,16 @@ Enable notifications
 
 From Mattermost v9.9 and desktop app v5.5, Mattermost prompts you to enable notifications in the desktop app the first time you connect to a Mattermost server.
 
+.. image:: ../images/desktop-notification-prompt.png
+  :alt: An example of a Mattermost desktop app notification prompt.
+  :scale: 50
+
 - When you select **Allow**, you won't be asked again. You'll start receiving notifications in the desktop app for all Mattermost activity with `badges <#badge-based-notifications>`__, `banner alerts <#banner-alerts>`__ and `sounds <#notification-sounds>`__. See the section below on `customizing your notifications <#customize-your-notifications>`__ based on how you prefer to be notified about Mattermost activity in the desktop app.
 - If you select **Deny** or **Deny Permanently**, you won't be asked again. You won't receive Mattermost notifications in the web browser. You can change this preference by :ref:`editing the server connection <preferences/connect-multiple-workspaces:edit a server>` to :ref:`manage your notification permissions <preferences/connect-multiple-workspaces:manage system permissions>`.
 
 .. note::
 
   - You may also need to enable notifications in Windows, macOS, or Linux for Mattermost by changing your System Preferences.
-  - When you allow desktop notifications, you'll also receive a second prompt asking you to allow notifications in your default web browser.
-
-    .. image:: ../images/web-notification-prompt.png
-      :alt: An example of a Firefox web browser notification prompt.
-      :scale: 70
 
 Badge-based notifications
 -------------------------

source/preferences/manage-your-mobile-notifications.rst

@@ -44,26 +44,24 @@ Customize your notifications
 
 You can manage your mobile notifications in both the desktop app and the mobile app.
 
-Desktop app
-~~~~~~~~~~~~
+.. tab:: Desktop app
 
-In the desktop app, manage your mobile notification preferences by selecting the **Settings** |gear| icon located in the top right corner of the screen, and select **Notifications > Desktop and mobile notifications**.
+  In the desktop app, manage your mobile notification preferences by selecting the **Settings** |gear| icon located in the top right corner of the screen, and select **Notifications > Desktop and mobile notifications**.
 
-By default, you receive mobile notifications when your Mattermost availability is :ref:`away or offline <preferences/set-your-status-availability:set your availability>`.
+  By default, you receive mobile notifications when your Mattermost availability is :ref:`away or offline <preferences/set-your-status-availability:set your availability>`.
 
-- Want to receive mobile notifications when you're online too? Under **Trigger mobile notifications when I am**, select **Online, away, or offline**. Note that you won't be notified on your device if you're actively using Mattermost in a web browser. Alternatively, select **Offline** to receive fewer mobile notifications.
+  - Want to receive mobile notifications when you're online too? Under **Trigger mobile notifications when I am**, select **Online, away, or offline**. Note that you won't be notified on your device if you're actively using Mattermost in a web browser. Alternatively, select **Offline** to receive fewer mobile notifications.
 
-- Want different desktop and mobile notifications? Select **Use different settings for my mobile devices**, and then select **All new messages**, or **Mentions, direct messages and group messages**.
+  - Want different desktop and mobile notifications? Select **Use different settings for my mobile devices**, and then select **All new messages**, or **Mentions, direct messages and group messages**.
 
-Mobile app
-~~~~~~~~~~
+.. tab:: Mobile app
 
-In the mobile app, tap your profile picture, then tap **Settings > Notifications**.
+  In the mobile app, tap your profile picture, then tap **Settings > Notifications**.
 
-- Tap **Mentions** to disable notifications based on keywords that trigger mentions, including first name, username, channel-wide @mentions, and keywords you've specified.
-- Tap **Push Notifications** to choose what to be notified about.
+  - Tap **Mentions** to disable notifications based on keywords that trigger mentions, including first name, username, channel-wide @mentions, and keywords you've specified.
+  - Tap **Push Notifications** to choose what to be notified about.
 
-You can also :ref:`manage email notifications <preferences/manage-your-notifications:email notifications>` and :ref:`send automatic replies to direct messages <preferences/manage-your-thread-reply-notifications:send automatic replies to direct messages>` directly from your device.
+  You can also :ref:`manage email notifications <preferences/manage-your-notifications:email notifications>` and :ref:`send automatic replies to direct messages <preferences/manage-your-thread-reply-notifications:send automatic replies to direct messages>` directly from your device.
 
 Incoming Call notifications
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~

source/preferences/manage-your-web-notifications.rst

@@ -13,7 +13,7 @@ Manage your web notifications
 Enable notifications
 --------------------
 
-From Mattermost v9.10, Mattermost prompts you to enable notifications in your web browser.
+From Mattermost v9.10, Mattermost prompts you to grant permission to your web browser to show notifications. 
 
 .. image:: ../images/enable-notifications.png
   :alt: From Mattermost v9.10, you're prompted to enable notifications.
@@ -28,9 +28,11 @@ In a web browser, Mattermost icons display the following types of badges:
 
 - Numbered badges for unread :ref:`direct <collaborate/channel-types:direct messages>` :ref:`group <collaborate/channel-types:group messages>` messages, :doc:`@mentions </preferences/manage-your-mentions-keywords-notifications>`, and :doc:`keywords </preferences/manage-your-mentions-keywords-notifications>` you're actively watching.
 
- - A red dot badge means an unread @mention or keyword. |chrome-mention-badge|
+A red dot badge means you have unread @mentions, keywords, direct messages, and group messages. 
+|chrome-mention-badge|
 
- - A black dot badge means an unread direct or group message. |chrome-activity-badge|
+A black dot badge means you have unread activity in channels you're a member of. 
+|chrome-activity-badge|
 
 Notification sounds
 --------------------
@@ -47,7 +49,7 @@ Customize your notifications
 Reduce web notifications
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-To reduce the number of notifications you receive, select **Desktop and mobile notifications > Mentions, direct messages, and group messages**, and save your changes. 
+To reduce the number of notifications you receive, select **Desktop and mobile notifications > Mentions, direct messages, and group messages**, and save your changes. You can set this preference across all channels or for specific channels.
 
 With limited notifications enabled, you can also choose to receive notifications about replies to threads you're following by selecting **Notify me about replies to threads I'm following**.
 
@@ -74,4 +76,4 @@ Frequently asked questions
 Why am I prompted repeatedly enable notifications I don't want?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Mattermost will continue to prompt you to enable notifications in a web browser until you respond to the prompt. If you want to disable all Mattermost notifications, select **Enable notifications** when prompted, and then `disable all Mattermost web notifications <#disable-all-web-notifications>`__.
+Mattermost will continue to prompt you to grant permission to the browser to show notifications until you respond to the prompt. If you want to disable all Mattermost notifications, select **Enable notifications** when prompted, and then `disable all Mattermost web notifications <#disable-all-web-notifications>`__.