Fix documentation

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

Author: jgoeders

BUILDING.md

@@ -59,28 +59,26 @@ The following should be enough to get the tools, VPR GUI and tests going on a mo
 ./install_apt_packages.sh
 ```
 
-You will also need several Python packages.  It is best to do this within a Python virtual environment:
-
-```
+You will also need several Python packages.  You can optionally install and activate a Python virtual environment so that you do not need to modify your system Python installation:
+```shell
 make env
+source .venv/bin/activate
 ```
 
-Anytime you run the VTR flow or regressions tests (which use Python) you should activate the virtual environment in your terminal:
+Then to install the Python packages:
 
+```shell
+pip install -r requirements.txt
 ```
-source .venv/bin/activate
-```
 
-For documentation generation these additional packages are required:
+*NOTE: Anytime you run the VTR flow or regressions tests (which use Python) you should activate the virtual environment in your terminal.*
+
+For documentation generation these additional Python packages are required:
 
 ```shell
-apt-get install \
-	doxygen \
-	sphinx-common
 pip install -r doc/requirements.txt
 ```
 
-
 For development the following additional packages are useful:
 
 ```shell

doc/src/quickstart/index.rst

@@ -28,8 +28,9 @@ Then, to install the required Python packages within a new virtual environment:
 .. code-block:: bash
 
     > make env
+    > source .venv/bin/activate
+    > pip install -r requirements.txt
 
-This will create a Python virtual environment in ``.venv``; however, you won't need this environment until later in the tutorial when you reach the section on "Automatically Running the VTR Flow".
 
 Build VTR
 ---------

doc/src/vtr/install_vtr.rst

@@ -14,7 +14,7 @@ Install VTR
 The complete VTR flow has been tested on 64-bit Linux systems.
 The flow should work in other platforms (32-bit Linux, Windows with cygwin) but this is untested.
 
-.. seealso:: More information about building VTR can be found in the :ref:`developer_guide`
+.. seealso:: Full information about building VTR, including setting up required system packages and Python packages, can be found in the :ref:`Building VTR guide <building_vtr>`.
 
 Please :ref:`let us know <contact>` your experience with building VTR so that we can improve the experience for others.