From c42b663ecb8c2b993c43818be47923cef49e7ea4 Mon Sep 17 00:00:00 2001
From: JohnLu2004 <JohnLu10212004@gmail.com>
Date: Mon, 25 Mar 2024 20:22:13 -0400
Subject: [PATCH] help: Improve documentation for changing a status.

Expands web app instructions for setting a status to have
a tab for via user card and via personal menu.

Adds instructions for clearing a status via user card, via
personal menu, and for mobile.

Adds new svg file for the icon used in zulip/mobile for
clearing a status.

Fixes #29415.

Co-authored-by: Lauryn Menard <lauryn@zulip.com>
---
 help/include/clear-status.md         |   2 ++
 help/include/self-user-card.md       |   2 +-
 help/include/set-status.md           |   6 ++++
 help/status-and-availability.md      |  43 +++++++++++++++++++++++----
 static/images/help/mobile-x-icon.svg | Bin 0 -> 294 bytes
 5 files changed, 46 insertions(+), 7 deletions(-)
 create mode 100644 help/include/clear-status.md
 create mode 100644 help/include/set-status.md
 create mode 100644 static/images/help/mobile-x-icon.svg

diff --git a/help/include/clear-status.md b/help/include/clear-status.md
new file mode 100644
index 0000000000..23eccfc82b
--- /dev/null
+++ b/help/include/clear-status.md
@@ -0,0 +1,2 @@
+1. Click on the <i class="zulip-icon zulip-icon-x-circle"></i> to the
+   right of your current status.
diff --git a/help/include/self-user-card.md b/help/include/self-user-card.md
index 5f6d924db6..080cc081d2 100644
--- a/help/include/self-user-card.md
+++ b/help/include/self-user-card.md
@@ -1,4 +1,4 @@
 1. Hover over your name in the right sidebar.
 
 1. Click on the **ellipsis** (<i class="zulip-icon zulip-icon-more-vertical"></i>)
-   to open your **user card**.
+   to open your [**user card**](/help/user-cards).
diff --git a/help/include/set-status.md b/help/include/set-status.md
new file mode 100644
index 0000000000..0efc37a027
--- /dev/null
+++ b/help/include/set-status.md
@@ -0,0 +1,6 @@
+1. Click **Set status**.
+
+1. Click to select one of the common statuses, *or* choose any emoji and/or
+   write a short message.
+
+1. Click **Save**.
diff --git a/help/status-and-availability.md b/help/status-and-availability.md
index add6044e25..75f0b3b7a3 100644
--- a/help/status-and-availability.md
+++ b/help/status-and-availability.md
@@ -21,22 +21,23 @@ You can set a status emoji, status message, or both.
 
 {start_tabs}
 
-{tab|desktop-web}
+{tab|via-user-card}
 
 {!self-user-card.md!}
 
-1. Click **Set a status**.
+{!set-status.md!}
 
-1. Click to select one of the common statuses, *or* choose any emoji and/or
-   write a short message.
+{tab|via-personal-settings}
 
-1. Click **Save**.
+{!personal-menu.md!}
+
+{!set-status.md!}
 
 {tab|mobile}
 
 {!mobile-profile-menu.md!}
 
-1. Tap **Set a status**.
+1. Tap **Set your status**.
 
 1. Tap to select one of the common statuses, *or* choose any emoji and/or
    write a short message.
@@ -45,6 +46,36 @@ You can set a status emoji, status message, or both.
 
 {end_tabs}
 
+### Clear a status
+
+{start_tabs}
+
+{tab|via-user-card}
+
+{!self-user-card.md!}
+
+{!clear-status.md!}
+
+{tab|via-personal-settings}
+
+{!personal-menu.md!}
+
+{!clear-status.md!}
+
+{tab|mobile}
+
+{!mobile-profile-menu.md!}
+
+1. Tap **Set your status**.
+
+1. Tap the **x**
+   (<img src="/static/images/help/mobile-x-icon.svg" alt="x" class="help-center-icon"/>)
+   to the right of your current status.
+
+1. Tap **Save**.
+
+{end_tabs}
+
 ### View a status
 
 Status emoji are shown next to a user's name in the sidebars, message feed,
diff --git a/static/images/help/mobile-x-icon.svg b/static/images/help/mobile-x-icon.svg
new file mode 100644
index 0000000000000000000000000000000000000000..305d03ef181556f075ab6fba04bea7bf77bf50e5
GIT binary patch
literal 294
zcmZ9H(GJ2O3`KvXsm~jTi%~Q7;GZmx4HUr)9QgObbZShR+~(x8X=^tP5U<)ej?(+v
zfshbF88)RI2f`?&BpC=nbzX906@nCMkp9(AN`#}094Sy>RVsvDY0c4CBM_V)?L}~0
zZL2-&y9E@>x)0FGh*NvxINH1UdKsUsG9P}@txKo&qV-aY@XjJ)Q)d_An&Wzh@JP8u
Zh-{8WibR{5Wa&pu%8xk@{;B!><_TsAS-AiJ

literal 0
HcmV?d00001