diff --git a/docs/codeql/README.rst b/docs/codeql/README.rst
index d27fe2189d2..a07d15c27e1 100644
--- a/docs/codeql/README.rst
+++ b/docs/codeql/README.rst
@@ -42,9 +42,10 @@ For more information, see
 Building and previewing the CodeQL documentation
 ************************************************
 
-To build and preview the documentation and training presentations locally, you need to 
-install Sphinx 1.7.9. More recent versions of Sphinx do not work with hieroglyph, 
-the Sphinx extension that we use to generate HTML slides, as explained below. 
+To build and preview the documentation and training presentations locally, you need to
+install Sphinx 1.7.9 using Python 2 (for example: `pip install sphinx==1.7.9`).
+More recent versions of Sphinx do not work with hieroglyph,
+the Sphinx extension that we use to generate HTML slides, as explained below.
 For installation options, see https://github.com/sphinx-doc/sphinx.