From 4b3290566b749b4a27c4f1eb0f0b8297e590c7b6 Mon Sep 17 00:00:00 2001
From: majordwarf <tejastank10@gmail.com>
Date: Thu, 9 Apr 2020 04:19:42 +0530
Subject: [PATCH] docs: Document integration request process.

There was no proper documentation to guide user to request an integration.
The following changes documents the whole process and links it from the
`/integrations/` page making it visible to the end-user.

Fixes #7935
---
 static/styles/portico/integrations.css        | 13 ++++++++++
 .../zerver/help/include/sidebar_index.md      |  1 +
 .../zerver/help/request-an-integration.md     | 26 +++++++++++++++++++
 templates/zerver/integrations/index.html      |  6 +++++
 4 files changed, 46 insertions(+)
 create mode 100644 templates/zerver/help/request-an-integration.md

diff --git a/static/styles/portico/integrations.css b/static/styles/portico/integrations.css
index 3202caeb01..376394b3e5 100644
--- a/static/styles/portico/integrations.css
+++ b/static/styles/portico/integrations.css
@@ -433,6 +433,19 @@ $category-text: hsl(219, 23%, 33%);
         }
     }
 
+    .integration-request {
+        font-size: 1em;
+        padding: 10px 0;
+
+        p {
+            padding-bottom: 10px;
+        }
+
+        .button {
+            padding: 11px 25px 11px 25px;
+        }
+    }
+
     /* -- integration instructions -- */
 
     #integration-instructions-group {
diff --git a/templates/zerver/help/include/sidebar_index.md b/templates/zerver/help/include/sidebar_index.md
index 7ef951f0f8..7d04cf414b 100644
--- a/templates/zerver/help/include/sidebar_index.md
+++ b/templates/zerver/help/include/sidebar_index.md
@@ -86,6 +86,7 @@
 ## Tools & customization
 * [Bots and integrations](/help/bots-and-integrations)
 * [Add a bot or integration](/help/add-a-bot-or-integration)
+* [Request an integration](/help/request-an-integration)
 * [Create a poll](/help/create-a-poll)
 * [Night mode](/help/night-mode)
 * [Enable emoticon translations](/help/enable-emoticon-translations)
diff --git a/templates/zerver/help/request-an-integration.md b/templates/zerver/help/request-an-integration.md
new file mode 100644
index 0000000000..6dcefa951d
--- /dev/null
+++ b/templates/zerver/help/request-an-integration.md
@@ -0,0 +1,26 @@
+# Request an integration
+
+Zulip provides its user over 100 native integrations. Several hundred more are
+available through [Hubot](https://hubot.github.com/), [Zapier](https://zapier.com/home),
+and [IFTTT](https://ifttt.com/) but there can be times where you don’t find an integration
+or bot you need.
+
+In such cases, you can request the integration by filing a feature request on our
+GitHub issues page. While filing a feature request please provide as much detail
+and context as possible.
+
+## Filing an issue
+
+{start_tabs}
+
+1. Go to [Zulip's Issue page](https://github.com/zulip/zulip/issues).
+
+2. Click **New issue**.
+
+3. Fill out the fields, and click **Submit new issue**.
+
+!!! warn ""
+    Make sure no issue exists for the same integration request or feature
+    and once you are sure you can file an issue for the integration you want.
+
+{end_tabs}
diff --git a/templates/zerver/integrations/index.html b/templates/zerver/integrations/index.html
index dd646c7f4c..ba69c74725 100644
--- a/templates/zerver/integrations/index.html
+++ b/templates/zerver/integrations/index.html
@@ -133,6 +133,12 @@
                                 <h3 class="integration-name create-your-own">{% trans %}Create your own!{% endtrans %}</h3>
                             </div>
                         </a>
+                        <div class="integration-request center">
+                            <p>Don't see an integration you use? Learn how you can request it.</p>
+                            <a href="/help/request-an-integration" class="button green">
+                                Request an Integration
+                            </a>
+                        </div>
                     </div>
                 </div>