diff --git a/templates/zerver/api/writing-bots.md b/templates/zerver/api/writing-bots.md
index 92776cd8c8..90e335549b 100644
--- a/templates/zerver/api/writing-bots.md
+++ b/templates/zerver/api/writing-bots.md
@@ -56,10 +56,10 @@ class MyBotHandler(object):
     A docstring documenting this bot.
     '''
 
-    def usage(self):
+    def usage(self) -> str:
         return '''Your description of the bot'''
 
-    def handle_message(self, message, bot_handler):
+    def handle_message(self, message, bot_handler) -> None:
         # add your code here
 
 handler_class = MyBotHandler
@@ -176,7 +176,7 @@ is called to retrieve information about the bot.
 #### Example implementation
 
 ```
-def usage(self):
+def usage(self) -> str:
     return '''
         This plugin will allow users to flag messages
         as being follow-up items.  Users should preface
@@ -207,7 +207,7 @@ None.
 #### Example implementation
 
  ```
-  def handle_message(self, message, bot_handler):
+  def handle_message(self, message, bot_handler) -> None:
      original_content = message['content']
      original_sender = message['sender_email']
      new_content = original_content.replace('@followup',
@@ -408,7 +408,7 @@ refactor them.
     class TestHelloWorldBot(BotTestCase):
         bot_name = "helloworld"  # The bot's name (should be the name of the bot module to test).
 
-        def test_bot(self): # A test case (must start with `test`)
+        def test_bot(self) -> None: # A test case (must start with `test`)
             # Messages we want to test and the expected bot responses.
             message_response_pairs = [("", "beep boop"),
                                       ("foo", "beep boop"),
diff --git a/templates/zerver/markdown_help.html b/templates/zerver/markdown_help.html
index 1a97a57283..467ef97195 100644
--- a/templates/zerver/markdown_help.html
+++ b/templates/zerver/markdown_help.html
@@ -77,16 +77,16 @@
                     </tr>
                     <tr>
                     <td class="preserve_spaces">```
-def zulip():
-    print "Zulip"
+def zulip() -> None:
+    print("Zulip")
 ```</td>
-                    <td><pre>def zulip():
-    print "Zulip"</pre></td>
+                    <td><pre>def zulip() -> None:
+    print("Zulip")</pre></td>
                     </tr>
                     <tr>
                     <td class="preserve_spaces">```python
-def zulip():
-    print "Zulip"
+def zulip() -> None:
+    print("Zulip")
 ```</td>
                     <td>
                         <div class="codehilite"><pre><span class="k">def</span> <span class="nf">zulip</span><span class="p">():</span>