docs: Add user guide for starring messages

templates/zerver/help/index.md

@@ -66,7 +66,7 @@ as a “**realm**”.
 * [View the exact time a message was sent](/help/message-exact-time)
 * [View an image at full size](/help/image-full-size)
 * [Collapse a message](/help/collapse-a-message)
-* Star a message
+* [Star a message](/help/starring-messages)
 * Share a message or conversation (permanent link)
 ### Editing
 * [Edit or delete a message](/help/editing-past-messages)

templates/zerver/help/starring-messages.md

@@ -0,0 +1,23 @@
+# Starring a message
+Starring messages is a good way to keep track of important messages, such as tasks you need to go back to, or documents you reference often.
+### Star a message
+You can star a message by hovering over any message. The timestamp of the message should be replaced with three context buttons while hovering, one of which is a star. Click on this to star the message.
+
+![Message example](/static/images/help/starring-messages-unstarred.png)
+
+When a message is starred, a small green star appears next to the timestamp of the message.
+
+![Message example](/static/images/help/starring-messages-starred.png)
+
+### Unstar a message
+Click on the green star to unstar a message, returning it to being unfilled.
+
+### View a starred message
+You can view all messages you've starred by filtering with the term `is:starred`. This term can be combined with any other filter or search term.
+
+![Message example](/static/images/help/starring-messages-filtering.png)
+
+You can also click the "Starred Messages" option on the sidebar to filter to only starred messages.
+
+![Message example](/static/images/help/starring-messages-view-starred.png)
+