From 2b7cca96d2eabe1fa2d407cf8f283a88587c25dd Mon Sep 17 00:00:00 2001
From: Jordan Rob Byamugisha <jordanrob709@gmail.com>
Date: Thu, 28 Oct 2021 18:14:28 +0300
Subject: [PATCH] help: Add documentation on resizing the compose box.

Co-authored-by: Alya Abbott <alya@zulip.com>

Fixes #20017.
---
 .../zerver/help/include/sidebar_index.md      |  1 +
 templates/zerver/help/open-the-compose-box.md |  1 +
 .../zerver/help/resize-the-compose-box.md     | 39 +++++++++++++++++++
 3 files changed, 41 insertions(+)
 mode change 100644 => 100755 templates/zerver/help/include/sidebar_index.md
 mode change 100644 => 100755 templates/zerver/help/open-the-compose-box.md
 create mode 100644 templates/zerver/help/resize-the-compose-box.md

diff --git a/templates/zerver/help/include/sidebar_index.md b/templates/zerver/help/include/sidebar_index.md
old mode 100644
new mode 100755
index 08df9590cf..a44ca760c7
--- a/templates/zerver/help/include/sidebar_index.md
+++ b/templates/zerver/help/include/sidebar_index.md
@@ -56,6 +56,7 @@
 
 ## Sending messages
 * [Open the compose box](/help/open-the-compose-box)
+* [Resize the compose box](/help/resize-the-compose-box)
 * [Format messages using Markdown](/help/format-your-message-using-markdown)
 * [Mention a user or group](/help/mention-a-user-or-group)
 * [Preview messages before sending](/help/preview-your-message-before-sending)
diff --git a/templates/zerver/help/open-the-compose-box.md b/templates/zerver/help/open-the-compose-box.md
old mode 100644
new mode 100755
index e18cad885f..78ad91e106
--- a/templates/zerver/help/open-the-compose-box.md
+++ b/templates/zerver/help/open-the-compose-box.md
@@ -37,3 +37,4 @@ can close the compose box using `Esc`, or up/down arrow if the box is empty.
 * [Replying to messages](/help/replying-to-messages)
 * [Messaging tips & tricks](/help/messaging-tips)
 * [Keyboard shortcuts](/help/keyboard-shortcuts)
+* [Resize the compose box](/help/resize-the-compose-box)
diff --git a/templates/zerver/help/resize-the-compose-box.md b/templates/zerver/help/resize-the-compose-box.md
new file mode 100644
index 0000000000..c4c1654c3b
--- /dev/null
+++ b/templates/zerver/help/resize-the-compose-box.md
@@ -0,0 +1,39 @@
+# Resize the compose box
+
+When composing a long message, it can be helpful to expand the compose
+box to display more text and avoid distractions. Note that the compose
+box also stretches automatically when you type a long message.
+
+## Expand the compose box
+
+{start_tabs}
+
+{!start-composing.md!}
+
+1. Click on the **<i class="fa fa-chevron-up"></i> icon** in the top
+   right corner of the compose box.
+
+{end_tabs}
+
+## Collapse the compose box
+
+{start_tabs}
+
+1. With the compose box in the expanded state, click on the **<i class="fa
+   fa-chevron-down"></i> icon** in the top right corner of the compose box.
+
+{end_tabs}
+
+## Stretch the compose box
+
+{start_tabs}
+
+{!start-composing.md!}
+
+1. Click and drag the bottom right corner of the compose box.
+
+{end_tabs}
+
+## Related articles
+
+* [Open the compose box](/help/open-the-compose-box)