From 0f4d40f3ecebdb1c369d94b805067b8a2b6464e2 Mon Sep 17 00:00:00 2001
From: David Rosa <rosatamsen@gmail.com>
Date: Sat, 21 Oct 2023 15:35:37 -0700
Subject: [PATCH] help: Update `follow-a-topic.md`.

- Adds Markdown include blocks for reusability in `mute-a-topic.md`.
- Adds icons for configuring topic notifications.
---
 help/follow-a-topic.md                          | 17 ++++-------------
 ...configure-topic-notifications-desktop-web.md | 11 +++++++++++
 help/include/configure-topic-notifications.md   | 10 +---------
 .../manage-configured-topics-desktop-web.md     |  4 ++++
 help/include/manage-configured-topics.md        |  5 +----
 5 files changed, 21 insertions(+), 26 deletions(-)
 create mode 100644 help/include/configure-topic-notifications-desktop-web.md
 create mode 100644 help/include/manage-configured-topics-desktop-web.md

diff --git a/help/follow-a-topic.md b/help/follow-a-topic.md
index 81f674e4f8..f7f90f0da3 100644
--- a/help/follow-a-topic.md
+++ b/help/follow-a-topic.md
@@ -1,6 +1,7 @@
 # Follow a topic
 
-Zulip lets you follow topics you are interested in. You can configure how you get notified about new messages for topics you follow.
+Zulip lets you follow topics you are interested in. You can configure how you
+get notified about new messages for topics you follow.
 
 In muted streams, topics you follow are automatically treated as
 [unmuted](/help/mute-a-topic).
@@ -11,14 +12,7 @@ In muted streams, topics you follow are automatically treated as
 
 {tab|desktop-web}
 
-{!topic-actions.md!}
-
-1. Configure topic notifications using the row of icons at the top of the menu.
-
-!!! tip ""
-
-    You can also configure notifications by clicking the topic notifications status
-    icon in the message recipient bar or in **Recent conversations**.
+{!configure-topic-notifications-desktop-web.md!}
 
 {end_tabs}
 
@@ -39,10 +33,7 @@ In muted streams, topics you follow are automatically treated as
 
 {tab|desktop-web}
 
-{settings_tab|topics}
-
-1. Configure notifications for each topic by selecting the desired option from
-   the dropdown in the **Status** column.
+{!manage-configured-topics-desktop-web.md!}
 
 {end_tabs}
 
diff --git a/help/include/configure-topic-notifications-desktop-web.md b/help/include/configure-topic-notifications-desktop-web.md
new file mode 100644
index 0000000000..d6acd6cc54
--- /dev/null
+++ b/help/include/configure-topic-notifications-desktop-web.md
@@ -0,0 +1,11 @@
+{!topic-actions.md!}
+
+1. Configure topic notifications using the row of icons at the top of the menu.
+
+!!! tip ""
+
+    You can also configure notifications by clicking the topic notifications
+    status icon (<i class="zulip-icon zulip-icon-mute-new"></i>,
+    <i class="zulip-icon zulip-icon-unmute-new"></i>, or
+    <i class="zulip-icon zulip-icon-follow"></i>) in the message recipient bar,
+    in the **Inbox view**, or in **Recent conversations**.
diff --git a/help/include/configure-topic-notifications.md b/help/include/configure-topic-notifications.md
index 0aa8372d95..f6ef2cbfcc 100644
--- a/help/include/configure-topic-notifications.md
+++ b/help/include/configure-topic-notifications.md
@@ -2,15 +2,7 @@
 
 {tab|desktop-web}
 
-{!topic-actions.md!}
-
-1. Configure topic notifications using the row of icons at the top of the menu.
-
-!!! tip ""
-
-    You can also configure notifications by clicking the topic notifications status
-    icon in the message recipient bar, in the **Inbox view**, or in
-    **Recent conversations**.
+{!configure-topic-notifications-desktop-web.md!}
 
 {tab|mobile}
 
diff --git a/help/include/manage-configured-topics-desktop-web.md b/help/include/manage-configured-topics-desktop-web.md
new file mode 100644
index 0000000000..abc645abab
--- /dev/null
+++ b/help/include/manage-configured-topics-desktop-web.md
@@ -0,0 +1,4 @@
+{settings_tab|topics}
+
+1. Configure notifications for each topic by selecting the desired option from
+   the dropdown in the **Status** column.
diff --git a/help/include/manage-configured-topics.md b/help/include/manage-configured-topics.md
index 4de526397b..09c2c9572a 100644
--- a/help/include/manage-configured-topics.md
+++ b/help/include/manage-configured-topics.md
@@ -2,10 +2,7 @@
 
 {tab|desktop-web}
 
-{settings_tab|topics}
-
-1. Configure notifications for each topic by selecting the desired option from
-   the dropdown in the **Status** column.
+{!manage-configured-topics-desktop-web.md!}
 
 {tab|mobile}