From e510c5d15a94a0e83ecd0b5f0f95fff4c9200a62 Mon Sep 17 00:00:00 2001
From: Eeshan Garg <jerryguitarist@gmail.com>
Date: Fri, 2 Jun 2017 00:12:28 -0230
Subject: [PATCH] webhooks/pivotal: Migrate docs to Markdown.

---
 zerver/webhooks/pivotal/doc.html | 35 --------------------------------
 zerver/webhooks/pivotal/doc.md   | 20 ++++++++++++++++++
 2 files changed, 20 insertions(+), 35 deletions(-)
 delete mode 100644 zerver/webhooks/pivotal/doc.html
 create mode 100644 zerver/webhooks/pivotal/doc.md

diff --git a/zerver/webhooks/pivotal/doc.html b/zerver/webhooks/pivotal/doc.html
deleted file mode 100644
index f68044b400..0000000000
--- a/zerver/webhooks/pivotal/doc.html
+++ /dev/null
@@ -1,35 +0,0 @@
-<p>
-  Zulip supports integration with Pivotal Tracker and can notify you of changes
-to the stories in your Pivotal Tracker project.
-</p>
-
-<p>
-  First, create the stream you'd like to use for Pivotal Tracker
-notifications, and subscribe all interested parties to this stream. We
-recommend the name <code>pivotal</code>.
-</p>
-
-<p>
-  Next, in the Settings page for your project, choose the Integrations
-tab. Scroll down to the <code>Activity Web Hook</code> section, and enter
-the following url:
-</p>
-
-<p><code>{{ external_api_uri_subdomain }}/v1/external/pivotal?api_key=abcdefgh&amp;stream=pivotal</code></p>
-
-<p>
-  where <code>api_key</code> is the API key of your Zulip bot,
-and <code>stream</code> is the stream name you want the
-notifications sent to.
-</p>
-
-<p>
-  Choose version 5 of the API. Zulip supports both version 3 and version 5, but
-version 5 contains more information that lets Zulip format more useful messages.
-</p>
-
-<img class="screenshot" src="/static/images/integrations/pivotal/001.png"/>
-
-<p><b>Congratulations! You're done!</b><br/> When you make changes in Pivotal Tracker they will be reflected in Zulip:
-</p>
-<img class="screenshot" src="/static/images/integrations/pivotal/002.png"/>
diff --git a/zerver/webhooks/pivotal/doc.md b/zerver/webhooks/pivotal/doc.md
new file mode 100644
index 0000000000..d41b54c971
--- /dev/null
+++ b/zerver/webhooks/pivotal/doc.md
@@ -0,0 +1,20 @@
+Zulip supports integration with Pivotal Tracker and can notify
+you of changes to the stories in your Pivotal Tracker project.
+
+{!create-stream.md!}
+
+{!create-bot-construct-url.md!}
+
+Next, in the **Settings** page for your project, choose the
+**Integrations** tab. Scroll down to the **Activity Web Hook**
+section, and enter the URL created above.
+
+Choose version 5 of the API. Zulip supports both version 3 and
+version 5, but version 5 contains more information that lets
+Zulip format more useful messages.
+
+![](/static/images/integrations/pivotal/001.png)
+
+{!congrats.md!}
+
+![](/static/images/integrations/pivotal/002.png)