From babe5ed44af76b8fa9858aedd2d239c221e70945 Mon Sep 17 00:00:00 2001
From: Lauryn Menard <lauryn@zulip.com>
Date: Tue, 22 Mar 2022 18:13:30 +0100
Subject: [PATCH] help: Update notifications docs for changes.

Adds documentation for unread badge count to help article on
desktop notifications.

Generally, cleans up instructions and article structure for
the help article on pms, mentions and alerts.

Co-authored-by: Alya Abbott <alya@zulip.com>
---
 .../zerver/help/desktop-notifications.md      | 27 ++++++++++++++++---
 .../help/pm-mention-alert-notifications.md    | 24 ++++++++++-------
 2 files changed, 39 insertions(+), 12 deletions(-)

diff --git a/templates/zerver/help/desktop-notifications.md b/templates/zerver/help/desktop-notifications.md
index fd916dd267..697f7b046c 100644
--- a/templates/zerver/help/desktop-notifications.md
+++ b/templates/zerver/help/desktop-notifications.md
@@ -6,9 +6,10 @@ customize whether [stream messages](/help/stream-notifications),
 [mentions](/help/pm-mention-alert-notifications#wildcard-mentions)
 trigger desktop notifications.
 
-## Change notification sound
+## Notification sound
 
-You can change the sound Zulip uses for audible desktop notifications.
+You can select the sound Zulip uses for audible desktop notifications. Choosing
+**None** disables all audible desktop notifications.
 
 ### Change notification sound
 
@@ -21,7 +22,27 @@ You can change the sound Zulip uses for audible desktop notifications.
 
 {end_tabs}
 
-You can select "None" to completely disable audible desktop notifications in Zulip.
+!!! tip ""
+    To hear the selected sound, click the <i class="fa fa-play-circle"></i> to the right of your selection.
+
+## Unread count badge
+
+By default, Zulip displays how many unmuted unread messages you have
+in the organization on the [desktop app](https://zulip.com/apps/)
+sidebar and on the browser tab icon. You can configure which types of
+messages are included in the count. Choosing **None** disables unread
+count badges.
+
+### Configure unread count badge
+
+{start_tabs}
+
+{settings_tab|notifications}
+
+1. Under **Desktop message notifications**, configure
+   **Unread count badge**.
+
+{end_tabs}
 
 ## Troubleshooting desktop notifications
 
diff --git a/templates/zerver/help/pm-mention-alert-notifications.md b/templates/zerver/help/pm-mention-alert-notifications.md
index dbad5b6570..11e2f1e5f4 100644
--- a/templates/zerver/help/pm-mention-alert-notifications.md
+++ b/templates/zerver/help/pm-mention-alert-notifications.md
@@ -1,38 +1,44 @@
 # PMs, mentions, and alerts
 
 You can configure desktop, mobile, and email notifications for
-[private messages](/help/private-messages),
+[private messages (PMs)](/help/private-messages),
 [mentions](/help/mention-a-user-or-group), and [alert
 words](#alert-words).
 
+## Configure notifications
+
+These settings will affect notifications for private messages, group
+private messages, mentions, and alert words.
+
 {start_tabs}
 
 {settings_tab|notifications}
 
-1. Toggle the notification settings under **Private messages,
-   @-mentions, and alert words**.
+1. In the **Notification triggers** table, toggle the settings for **PMs, mentions, and alerts**.
 
 {end_tabs}
 
-These settings will affect notifications for private messages, group
-private messages, mentions, and alert words.
-
 You can also hide the content of private messages (and group private
 messages) from desktop notifications.
-Under **Other notification settings**, uncheck
+
+{start_tabs}
+
+1. Under **Desktop message notifications**, toggle
 **Include content of private messages in desktop notifications**.
 
+{end_tabs}
+
 ## Wildcard mentions
 
 By default, wildcard mentions (`@**all**`, `@**everyone**`) trigger
 email/push notifications as though they were personal @-mentions.  You
-can toggle whether you receive notifications for wildcard mentions:
+can toggle whether you receive notifications for wildcard mentions.
 
 {start_tabs}
 
 {settings_tab|notifications}
 
-1. Under **Streams**, toggle the **@all** checkbox.
+1.  In the **Notification triggers** table, toggle the **@all** checkbox for **Streams**.
 
 {end_tabs}