From 17528e4ee98d6bb74a8aa61b9a5eb8ab087c5052 Mon Sep 17 00:00:00 2001
From: Rishi Gupta <rishig@zulipchat.com>
Date: Tue, 2 Apr 2019 23:09:36 -0700
Subject: [PATCH] help: Add create-a-poll.md.

---
 templates/zerver/help/create-a-poll.md        | 30 +++++++++++++++++++
 .../format-your-message-using-markdown.md     |  8 +++++
 .../zerver/help/include/sidebar_index.md      |  1 +
 3 files changed, 39 insertions(+)
 create mode 100644 templates/zerver/help/create-a-poll.md

diff --git a/templates/zerver/help/create-a-poll.md b/templates/zerver/help/create-a-poll.md
new file mode 100644
index 0000000000..225684f0a6
--- /dev/null
+++ b/templates/zerver/help/create-a-poll.md
@@ -0,0 +1,30 @@
+# Create a poll
+
+Zulip natively supports creating and editing lightweight polls.
+
+To create a poll, send a message like
+```
+/poll <name of poll>
+```
+or
+```
+/poll <name of poll>
+option 1
+option 2
+...
+```
+
+Once the poll is created, you'll be able to edit the name of the poll and
+add options, but you won't be able to edit options once they are created.
+
+Note that anyone can add options to any poll, though only the poll creator
+can edit the name.
+
+## Troubleshooting
+
+`/poll` must come at the beginning of the message. It is not possible to
+send a message that both has a poll and has any other content.
+
+## Related articles
+
+* [Format messages using Markdown](/help/format-your-message-using-markdown)
diff --git a/templates/zerver/help/format-your-message-using-markdown.md b/templates/zerver/help/format-your-message-using-markdown.md
index b096881499..55d644ec9a 100644
--- a/templates/zerver/help/format-your-message-using-markdown.md
+++ b/templates/zerver/help/format-your-message-using-markdown.md
@@ -209,6 +209,14 @@ Under the line
 
 A summary of the formatting syntax is available in-app.
 
+{start_tabs}
+
 {!start-composing.md!}
 
 1. Click the A (<i class="fa fa-font"></i>) icon at the bottom of the compose box.
+
+{end_tabs}
+
+## Related articles
+
+* [Create a poll](/help/create-a-poll)
diff --git a/templates/zerver/help/include/sidebar_index.md b/templates/zerver/help/include/sidebar_index.md
index a2b5eb5763..7f1e21ee77 100644
--- a/templates/zerver/help/include/sidebar_index.md
+++ b/templates/zerver/help/include/sidebar_index.md
@@ -83,6 +83,7 @@
 ## Tools & customization
 * [Bots and integrations](/help/bots-and-integrations)
 * [Add a bot or integration](/help/add-a-bot-or-integration)
+* [Create a poll](/help/create-a-poll)
 * [Night mode](/help/night-mode)
 * [Enable emoticon translations](/help/enable-emoticon-translations)
 * [Manage your uploaded files](/help/manage-your-uploaded-files)