diff --git a/README.md b/README.md
index c9eab76e52..b34467ca4c 100644
--- a/README.md
+++ b/README.md
@@ -23,8 +23,8 @@ at https://www.zulip.org.
 ## Installing the Zulip Development environment
 
 The Zulip development environment is the recommended option for folks
-interested in trying out Zulip.  This is documented in
-[README.dev.md](https://github.com/zulip/zulip/blob/master/README.dev.md).
+interested in trying out Zulip.  This is documented in [the developer
+installation guide][dev-install].
 
 ## Running Zulip in production
 
@@ -78,11 +78,12 @@ PostgreSQL extension][tsearch], as separate repos.
 contributing!
 
 [cla]: https://opensource.dropbox.com/cla/
+[dev-install]: https://github.com/zulip/zulip/blob/master/README.dev.md
 [doc]: https://zulip.readthedocs.io/
 [doc-commit-style]: http://zulip.readthedocs.io/en/latest/code-style.html#commit-messages
 [doc-dirstruct]: http://zulip.readthedocs.io/en/latest/directory-structure.html
 [doc-newfeat]: http://zulip.readthedocs.io/en/latest/new-feature-tutorial.html
-[doc-test]: https://github.com/zulip/zulip/blob/master/README.dev.md#running-the-test-suite
+[doc-test]: http://zulip.readthedocs.io/en/latest/testing.html
 [gg-devel]: https://groups.google.com/forum/#!forum/zulip-devel
 [gh-issues]: https://github.com/zulip/zulip/issues
 [desktop]: https://github.com/zulip/zulip-desktop
diff --git a/docs/brief-install-vagrant-dev.md b/docs/brief-install-vagrant-dev.md
index 64e08d2370..f63f7d4f6c 100644
--- a/docs/brief-install-vagrant-dev.md
+++ b/docs/brief-install-vagrant-dev.md
@@ -78,7 +78,7 @@ environments).
 At this point you should [read about using the development
 environment][using-dev].
 
-[using-dev]: #using-the-development-environment
+[using-dev]: using-dev-environment.html
 
 ### Specifying a proxy
 
diff --git a/docs/integration-guide.md b/docs/integration-guide.md
index b5ed0b9ee5..bded62f1f6 100644
--- a/docs/integration-guide.md
+++ b/docs/integration-guide.md
@@ -93,9 +93,8 @@ Here's how we recommend doing it:
   test-backend zerver.tests.test_hooks.PagerDutyHookTests
   ```
 
-  See
-  https://github.com/zulip/zulip/blob/master/README.dev.md#running-the-test-suite
-  for more details on the Zulip test runner.
+  See [this guide](testing.html) for more details on the Zulip test
+  runner.
 
 * Once you've gotten your webhook working and passing a test, capture
   payloads for the other common types of posts the service's webhook