integrations/asana: Migrate docs to Markdown.

templates/zerver/integrations/asana.html

@@ -1,76 +0,0 @@
-<p>Get Zulip notifications for your Asana projects via Zapier!</p>
-
-<p>
-    First, create the stream you'd like to use for Asana notifications, and
-    subscribe all interested parties to this stream. We recommend the
-    name <code>asana</code>.
-</p>
-
-<p><code>{{ external_api_uri_subdomain }}/v1/external/zapier?api_key=abcdefgh&amp;stream=asana</code></p>
-
-<p>Start by setting up a <a href="https://zapier.com/">Zapier</a> account.</p>
-
-<p>
-    Next, create a ZAP, picking Asana as the app you'd like
-    to receive notifications from as <code>Trigger (Step 1)</code>:
-</p>
-<img class="screenshot" src="/static/images/integrations/asana/001.png"/>
-
-<p>
-    Next, select the Asana event that you'd like to receive notifications
-    for (<code>Choose Trigger</code>), such as when you add a new Task in
-    an Asana project:
-</p>
-<img class="screenshot" src="/static/images/integrations/asana/002.png"/>
-
-<p>
-    Next, click on <code>Connect a New Account</code> and follow the steps
-    to connect your Asana account to the Zap:
-</p>
-<img class="screenshot" src="/static/images/integrations/asana/003.png"/>
-
-<p>
-    Select the Asana project you'd like to receive notifications for:
-</p>
-<img class="screenshot" src="/static/images/integrations/asana/004.png"/>
-
-<p>
-    In <code>Action (Step 2)</code>, select <code>Webhooks by Zapier</code>
-    as the app:
-</p>
-<img class="screenshot" src="/static/images/integrations/asana/005.png"/>
-
-<p>and <code>POST</code> as the action:</p>
-<img class="screenshot" src="/static/images/integrations/asana/006.png"/>
-
-<p>
-    Configure <code>Set up Webhooks by Zapier POST</code> as follows:
-
-    <ul>
-        <li><code>URL</code> is the URL we created above</li>
-        <li><code>Payload Type</code> set to <code>JSON</code></li>
-    </ul>
-</p>
-
-<p>
-    Finally, configure <code>Data</code>.
-    You have to add 2 fields:
-    <ul>
-        <li><code>subject</code> is field corresponding to a subject of the message</li>
-        <li><code>content</code> is field corresponding to a content of the message</li>
-    </ul>
-    You can format the content of the <code>content</code> and <code>subject</code>
-    fields in a number of ways as per your requirements.
-</p>
-
-<p>Here's an example configuration:</p>
-<img class="screenshot" src="/static/images/integrations/asana/007.png"/>
-
-<p>You're done! Example message:</p>
-<img class="screenshot" src="/static/images/integrations/asana/008.png"/>
-
-<p>
-    You can repeat the above process and create Zaps for different projects
-    and/or different kinds of Asana events that you'd like to receive
-    notifications about.
-</p>

templates/zerver/integrations/asana.md

@@ -0,0 +1,64 @@
+Get Zulip notifications for your Asana projects via Zapier!
+
+{!create-stream.md!}
+
+Next, on your {{ settings_html|safe }}, create a bot for Asana.
+Construct the URL for the Asana bot using the bot API key and
+stream name, like so:
+
+`{{ external_api_uri_subdomain }}/v1/external/zapier?api_key=abcdefgh&stream=asana`
+
+Start by setting up a [Zapier](https://zapier.com/) account.
+
+Next, create a ZAP, picking Asana as the app you'd like
+to receive notifications from as the **Trigger (Step 1)**:
+
+![](/static/images/integrations/asana/001.png)
+
+Next, select the Asana event that you'd like to receive notifications
+for (**Choose Trigger**), such as when you add a new **Task** in
+an Asana project:
+
+![](/static/images/integrations/asana/002.png)
+
+Next, click on **Connect a New Account** and follow the steps
+to connect your Asana account to the Zap:
+
+![](/static/images/integrations/asana/003.png)
+
+Select the Asana project you'd like to receive notifications for:
+
+![](/static/images/integrations/asana/004.png)
+
+In **Action (Step 2)**, select **Webhooks by Zapier** as the app:
+
+![](/static/images/integrations/asana/005.png)
+
+and `POST` as the action:
+
+![](/static/images/integrations/asana/006.png)
+
+Configure **Set up Webhooks by Zapier POST** as follows:
+
+* `URL` is the URL we created above
+* `Payload Type` set to `JSON`
+
+Finally, configure **Data**. You have to add 2 fields:
+
+* `subject` is the field corresponding to the subject of the message
+* `content` is the field corresponding to the content of the message
+
+You can format the content of the `content` and `subject` fields
+in a number of ways as per your requirements.
+
+Here's an example configuration:
+
+![](/static/images/integrations/asana/007.png)
+
+{!congrats.md!}
+
+![](/static/images/integrations/asana/008.png)
+
+You can repeat the above process and create Zaps for different projects
+and/or different kinds of Asana events that you'd like to be notified
+about in Zulip.

zerver/lib/integrations.py

@@ -249,7 +249,7 @@ WEBHOOK_INTEGRATIONS = [
 ]  # type: List[WebhookIntegration]
 
 INTEGRATIONS = {
-    'asana': Integration('asana', 'asana', doc='zerver/integrations/asana.html'),
+    'asana': Integration('asana', 'asana', doc='zerver/integrations/asana.md'),
     'capistrano': Integration('capistrano', 'capistrano', display_name='Capistrano', doc='zerver/integrations/capistrano.md'),
     'codebase': Integration('codebase', 'codebase', doc='zerver/integrations/codebase.md'),
     'email': EmailIntegration('email', 'email', doc='zerver/integrations/email.html'),