help: Add status-and-availability.

static/styles/portico.scss

@@ -1794,6 +1794,20 @@ input.new-organization-button {
     border: 1px solid hsl(0, 0%, 80%);
 }
 
+.markdown .indicator.grey-line {
+    border: 1px solid hsl(0, 0%, 80%);
+    top: 2px;
+
+    &::after {
+        content: '';
+        background: hsl(0, 0%, 80%);
+        height: 1.5px;
+        width: 6px;
+        display: block;
+        margin: .5px -2px;
+    }
+}
+
 .markdown .indicator.orange {
     border: 1px solid hsl(29, 84%, 51%);
     background: linear-gradient(to bottom, hsla(0, 0%, 100%, 0.0) 50%, hsla(29, 84%, 51%, 1.0) 50%);

templates/zerver/help/check-whether-someone-is-here-or-away.md

@@ -1,29 +0,0 @@
-# Check whether someone is here or away
-
-You can check a user's status in the **user list** in the right sidebar.
-
-* A green circle (<span class="indicator green solid"></span>) means the
-  user is “active” — they have interacted with Zulip in the last few
-  minutes, and have Zulip open on their computer.
-
-* An orange half-filled circle (<span class="indicator orange"></span>)
-  means the user is not active, but has Zulip open on their computer.
-
-* A white circle (<span class="indicator grey"></span>) means the user does
-  not have Zulip open.
-
-!!! tip ""
-    You can also view a user's status by clicking on their profile
-    picture in the main message feed.
-
-If you have messaged users in a group PM, their names will appear at the
-bottom of the right sidebar. In that case, a green circle (<span
-class="indicator green solid"></span>) means all users in the group are
-active. A pale green circle (<span class="indicator green"></span>) means
-that some are active and some are not. A white circle (<span
-class="indicator grey"></span>) means that none are active.
-
-## Small windows
-
-The right sidebar only appears in windows more than 1025 pixels wide. You can also
-[move the user list to the left sidebar](/help/move-the-users-list-to-the-left-sidebar).

templates/zerver/help/include/sidebar_index.md

@@ -50,7 +50,7 @@
 * [View a message's edit history](/help/view-a-messages-edit-history)
 
 ## People
-* [Check whether someone is on-line](/help/check-whether-someone-is-here-or-away)
+* [Status and availability](/help/status-and-availability)
 * [View someone's profile](/help/view-someones-profile)
 * [Private messages](/help/private-messages)
 

templates/zerver/help/status-and-availability.md

@@ -0,0 +1,70 @@
+# Status and availability
+
+Status and availability let your teammates know roughly how quickly you'll
+be responding to messages.
+
+A **status** is a customizable message visible to all team members. A
+typical status might be "in a meeting", "on vacation", or "visiting SF next week".
+
+Your **availability** is a colored dot (like <span class="indicator green solid"></span>)
+that indicates if you're currently active on Zulip, idle,
+offline, or unavailable. If you're not current active, Zulip also lets your
+teammates know when you were last active.
+
+## Set a status
+
+{start_tabs}
+
+1. Hover over your name in the right sidebar.
+
+1. Click the down chevron (<i class="fa fa-chevron-down"></i>) to the right.
+
+1. Click **Set a status message**.
+
+1. Set a status messages and click **Save**.
+
+{end_tabs}
+
+You can view anyone else's status by hovering over their name in the left or
+right sidebar, or by clicking their name or avatar in the main message feed. If
+they haven't set a status, no status will appear.
+
+## About availability
+
+There are four possible availabilities:
+
+* **Active** (<span class="indicator green solid"></span>): Zulip is open and in
+  focus on web, desktop or mobile, or was in the last 140 seconds.
+
+* **Idle** (<span class="indicator orange"></span>): Zulip is open on your
+  computer (either desktop or web), but you are not active.
+
+* **Offline** (<span class="indicator grey"></span>): Zulip is not open on
+  your computer.
+
+* **Unavailable** (<span class="indicator grey-line"></span>): You can always
+  manually set your availability to unavailable.
+
+For [Group PMs](/help/private-messages), a green circle
+(<span class="indicator green solid"></span>)
+means all users in the group are active. A pale green circle (<span
+class="indicator green"></span>) means that some are active and some are
+not. A white circle (<span class="indicator grey"></span>) means that none
+are active.
+
+You can see when someone was last active by hovering over their name in the
+left or right sidebar.
+
+## Set yourself as unavailable
+
+{start_tabs}
+
+1. Hover over your name in the right sidebar.
+
+1. Click the down chevron (<i class="fa fa-chevron-down"></i>) to the right.
+
+1. Click **Set yourself as unavailable**.
+
+{end_tabs}
+
+This will also obscure whether you were recently active.