From 1f28b9cbe0c8844f93f4120e5c8cca94b10cb112 Mon Sep 17 00:00:00 2001
From: Alya Abbott <alya@zulip.com>
Date: Tue, 26 Sep 2023 16:35:49 -0700
Subject: [PATCH] help: Add "Follow a topic" page.

Co-authored-by: David <rosatamsen@gmail.com>
---
 help/follow-a-topic.md        | 53 +++++++++++++++++++++++++++++++++++
 help/include/sidebar_index.md |  1 +
 help/mute-a-topic.md          |  1 +
 3 files changed, 55 insertions(+)
 create mode 100644 help/follow-a-topic.md

diff --git a/help/follow-a-topic.md b/help/follow-a-topic.md
new file mode 100644
index 0000000000..81f674e4f8
--- /dev/null
+++ b/help/follow-a-topic.md
@@ -0,0 +1,53 @@
+# 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.
+
+In muted streams, topics you follow are automatically treated as
+[unmuted](/help/mute-a-topic).
+
+## Follow or unfollow a topic
+
+{start_tabs}
+
+{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**.
+
+{end_tabs}
+
+## Configure notifications for followed topics
+
+{start_tabs}
+
+{settings_tab|notifications}
+
+1. In the **Notification triggers** table,
+   toggle the settings for **Followed topics**.
+
+{end_tabs}
+
+## Manage configured topics
+
+{start_tabs}
+
+{tab|desktop-web}
+
+{settings_tab|topics}
+
+1. Configure notifications for each topic by selecting the desired option from
+   the dropdown in the **Status** column.
+
+{end_tabs}
+
+## Related articles
+
+* [Stream notifications](/help/stream-notifications)
+* [Mute or unmute a topic](/help/mute-a-topic)
+* [Mute or unmute a stream](/help/mute-a-stream)
diff --git a/help/include/sidebar_index.md b/help/include/sidebar_index.md
index c0dfed3347..95d593c264 100644
--- a/help/include/sidebar_index.md
+++ b/help/include/sidebar_index.md
@@ -138,6 +138,7 @@
 
 ## Notifications
 * [Stream notifications](/help/stream-notifications)
+* [Follow a topic](/help/follow-a-topic)
 * [DMs, mentions, and alerts](/help/dm-mention-alert-notifications)
 * [Mute or unmute a stream](/help/mute-a-stream)
 * [Mute or unmute a topic](/help/mute-a-topic)
diff --git a/help/mute-a-topic.md b/help/mute-a-topic.md
index 1226ffce3a..84cf955265 100644
--- a/help/mute-a-topic.md
+++ b/help/mute-a-topic.md
@@ -13,4 +13,5 @@
 ## Related articles
 
 * [Mute or unmute a stream](/help/mute-a-stream)
+* [Follow a topic](/help/follow-a-topic)
 * [Mute a user](/help/mute-a-user)