diff --git a/zulip_bots/zulip_bots/bots/converter/doc.md b/zulip_bots/zulip_bots/bots/converter/doc.md
index 415efc5..fac90cc 100644
--- a/zulip_bots/zulip_bots/bots/converter/doc.md
+++ b/zulip_bots/zulip_bots/bots/converter/doc.md
@@ -4,7 +4,7 @@ This bot allows users to perform conversions for various measurement units.
 
 ## Usage
 
-Run this bot as described in [here](http://zulip.readthedocs.io/en/latest/bots-guide.html#how-to-deploy-a-bot).
+Run this bot as described in [here](https://zulipchat.com/api/running-bots#running-a-bot).
 
 Use this bot with the following command
 
diff --git a/zulip_bots/zulip_bots/bots/virtual_fs/doc.md b/zulip_bots/zulip_bots/bots/virtual_fs/doc.md
index 1f43cd6..c8fa004 100644
--- a/zulip_bots/zulip_bots/bots/virtual_fs/doc.md
+++ b/zulip_bots/zulip_bots/bots/virtual_fs/doc.md
@@ -6,7 +6,7 @@ for a given stream or private chat.
 ## Usage
 
 Run this bot as described in
-[here](http://zulip.readthedocs.io/en/latest/bots-guide.html#how-to-deploy-a-bot).
+[here](https://zulipchat.com/api/running-bots#running-a-bot).
 
 Use this bot with any of the following commands:
 
diff --git a/zulip_bots/zulip_bots/bots_unmaintained/googlesearch/doc.md b/zulip_bots/zulip_bots/bots_unmaintained/googlesearch/doc.md
index 5310f3a..152abc1 100644
--- a/zulip_bots/zulip_bots/bots_unmaintained/googlesearch/doc.md
+++ b/zulip_bots/zulip_bots/bots_unmaintained/googlesearch/doc.md
@@ -7,7 +7,7 @@ highest safe-search setting.
 ## Usage
 
 Run this bot as described
-[here](http://zulip.readthedocs.io/en/latest/bots-guide.html#how-to-deploy-a-bot).
+[here](https://zulipchat.com/api/running-bots#running-a-bot).
 
 Use this bot with the following command
 
diff --git a/zulip_bots/zulip_bots/bots_unmaintained/john/john.py b/zulip_bots/zulip_bots/bots_unmaintained/john/john.py
index dbf6af3..8b5e60f 100644
--- a/zulip_bots/zulip_bots/bots_unmaintained/john/john.py
+++ b/zulip_bots/zulip_bots/bots_unmaintained/john/john.py
@@ -77,7 +77,7 @@ class JohnHandler(object):
             "I would like to request a remote dev instance",
             """Greetings! You should receive a response from one of our mentors soon.
             In the meantime, why don't you learn more about running Zulip on a development
-            environment? https://zulip.readthedocs.io/en/latest/using-dev-environment.html""",
+            environment? https://zulip.readthedocs.io/en/latest/development/using.html""",
         ])
         self.bot.train([
             "Joke!",