diff --git a/docs/README.md b/docs/README.md
index a1c8526e6ef5..9b6372524bd3 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,9 +1,11 @@
 Please make sure that you use the documents that match your Electron version.
-The version number should be a part of the URL. If it's not, you are probably
-using the documentation of a development branch which may contain API changes
-that are not compatible with your Electron version.
-When in doubt, run Electron without supplying an app path, and click on the 
-`docs` link.
+The version number should be a part of the page URL. If it's not, you are
+probably using the documentation of a development branch which may contain API
+changes that are not compatible with your Electron version. If that's the case,
+you can switch to a different version of the documentation at the
+[available versions](http://electron.atom.io/docs/) list on atom.io, or if
+you're using the GitHub interface, open the "Switch branches/tags" dropdown and
+select the tag that matches your version.
 
 ## Guides