1: Install Python. Any version is fine.
 *::https://www.python.org/downloads
 
-1: Install Sphinx. The recommended way to install Sphinx is via pip:
+1: Install Sphinx and related support packages. The recommended way to install Sphinx is via pip:
 {code}
-sudo pip install sphinx sphinx_rtd_theme
+sudo pip install sphinx sphinx_rtd_theme nbsphinx
 {endcode}
 On RHEL and CentOS *we do not support* installing Sphinx from yum or RPM. The available package is an old version which does not support all our extensions.
 For other Linux distributions, Windows and macOS, you can find instructions here:
@@ -19,9 +19,9 @@
 
 1: Install the HTCondor Python bindings.
 This could be via =pip= (make sure you get the right version, e.g. =pip install htcondor==8.8.1=), or by editing your =PYTHONPATH= environment variable to point at the =.so= files inside your HTCondor install.
-Note: on RTD itself, the docs are built using the =htcondor= version specified in =docs/requirements.txt=.
+Note: on RTD itself, the docs are built using the =htcondor= version read out of =CMakeLists.txt=
 
-1: Install the Python pathlib module:
+1: Install the Python pathlib module (if you aren't on Python >= 3.4):
 {code}
 sudo pip install pathlib
 {endcode}