Merge pull request #4422 from stsewd/doc-python-use-system-site-packages

Document python.use_system_site_packages option

Author: ericholscher

docs/yaml-config.rst

@@ -154,6 +154,22 @@ the highest supported minor version will be selected.
     python:
        version: 3.5
 
+python.use_system_site_packages
+```````````````````````````````
+
+* Default: ``false``
+* Type: Boolean
+
+When true, it gives the virtual environment access to the global site-packages directory.
+Depending on the :ref:`yaml-config:build.image`,
+Read the Docs includes some libraries like scipy, numpy, etc.
+See :ref:`builds:The build environment` for more details.
+
+.. code-block:: yaml
+
+    python:
+       use_system_site_packages: true
+
 .. _yaml__python__setup_py_install:
 
 python.setup_py_install