diff --git a/docs/README.md b/docs/README.md
index 234007fdaf..7c5a299aa9 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -18,8 +18,6 @@ You can also usually test your changes by pushing a branch to GitHub
 and looking at the content on the GitHub web UI, since GitHub renders
 Markdown.
 
-When editing the dependencies for the Zulip documentation, you'll want
-to edit both the root requirements.txt as well as
-`docs/requirements.readthedocs.txt` (which is used by ReadTheDocs to
-build the documentation quickly, without installing all of Zulip's
-dependencies).
+When editing dependencies for the Zulip documentation, you should edit
+`requirements/docs.txt` (which is used by ReadTheDocs to build the
+documentation quickly, without installing all of Zulip's dependencies).
diff --git a/docs/testing.md b/docs/testing.md
index 17764945f5..db15ea5e49 100644
--- a/docs/testing.md
+++ b/docs/testing.md
@@ -320,8 +320,9 @@ automatically in Zulip's Travis CI tests to avoid any regressions, but
 is not included in test-all since it is quite slow.
 
 To run tooks/check-py3, you need to install the modernize and future
-python packages (which are in the development environment's
-requirements.txt file).
+python packages (which are included in requirements/py3k.txt, which
+itself is included in requirements/dev.txt, so you probably already
+have these packages installed).
 
 To run check-py3 on just the python files in a particular directory, you
 can change the current working directory (e.g. cd zerver/) and run