WIP A few notes about python/pip/sphinx

Signed-off-by: Jeff Squyres <[email protected]>

Author: jsquyres

docs/developers/sphinx.rst

@@ -27,10 +27,19 @@ MPI Git clone directory:
 
 .. code-block:: sh
 
+   # Create the Python virtual environment
    shell$ cd TOP_OF_OPEN_MPI_GIT_CLONE
    shell$ python3 -m venv ompi-docs-venv
+   # Or: python3 -m virtualenv ompi-docs-venv
+   # Or: virtualenv --python=python3 ompi-docs-venv
+
+   # Activate the virtual environment
    shell$ . ./ompi-docs-venv/bin/activate
+
+   # Notice that the shell prompt changes
+   # Now install the required Python modules
    (ompi-docs-venv) shell$ pip3 install -r docs/requirements.txt
+   # Or: python3 -m pip install install -r docs/requirements.txt
 
 Note that sourcing the ``activate`` script will change your prompt to
 put the name of your virtual environment directory at the front, just
@@ -53,6 +62,7 @@ root privileges):
 
    shell$ cd TOP_OF_OPEN_MPI_GIT_CLONE
    shell$ pip3 install -r docs/requirements.txt
+   # Or: python3 -m pip install install -r docs/requirements.txt
 
 This will install Sphinx and some Python modules required for building
 the Open MPI documentation in a system-wide location.
@@ -76,6 +86,7 @@ permissions to run this command):
 
    shell$ cd TOP_OF_OPEN_MPI_GIT_CLONE
    shell$ pip3 install --user -r docs/requirements.txt
+   # Or: python3 -m pip install install -r docs/requirements.txt
 
 This will install Sphinx and some Python modules required for building
 the Open MPI documentation in a system-wide location.