Code review feedback

Author: absurdfarce

docs/installation.rst

@@ -91,17 +91,18 @@ details at `PYTHON-1351 <https://datastax-oss.atlassian.net/browse/PYTHON-1351>`
 
 Speeding Up Installation
 ^^^^^^^^^^^^^^^^^^^^^^^^
-
 By default, installing the driver through ``pip`` uses a pre-compiled, platform-specific wheel when available.
 If using a source distribution rather than a wheel, Cython is used to compile certain parts of the driver.
 This makes those hot paths faster at runtime, but the Cython compilation
 process can take a long time -- as long as 10 minutes in some environments.
 
 In environments where performance is less important, it may be worth it to
 :ref:`disable Cython as documented below <cython-extensions>`.
-You can also use ``build-concurrency`` key in the ``tool.cassandra-driver`` table of pyproject.toml to 
-increase the number of threads used to build the driver and any C extensions.
 
+Cython also supports concurrent builds of native extensions.  The ``build-concurrency`` key in the
+``tool.cassandra-driver`` table of pyproject.toml is an integer value which specifies the number of
+concurrent builds Cython may execute.  The value for this key must be a non-negative integer; the default is zero,
+indicating no concurrent builds.  The ``multiprocessing`` module must be installed if concurrent builds are used.
 
 OSX Installation Error
 ^^^^^^^^^^^^^^^^^^^^^^
@@ -143,7 +144,6 @@ Once the dependencies are installed, simply run::
 
     python setup.py install
 
-
 (*Optional*) Non-python Dependencies
 ------------------------------------
 The driver has several **optional** features that have non-Python dependencies.
@@ -156,7 +156,7 @@ for token-aware routing with the ``Murmur3Partitioner``,
 and Cython optimized extensions.
 
 When installing manually these options can be disabled by changing the corresponding
-key in the ``tool.cassandra-driver`` table of pyproject.toml to "false".  Please consult
+key in the ``tool.cassandra-driver`` table of pyproject.toml to ``false``.  Please consult
 the ``build-murmur3-extension``, ``build-libev-extension`` and ``build-cython-extensions``
 keys (respectively) to disable these extensions.
 
@@ -184,7 +184,7 @@ pure Python implementation.
 
 This process does take some time, however, so if you wish to build without generating these extensions using
 Cython you can do so by changing the ``build-cython-extensions`` key in the ``tool.cassandra-driver`` table of pyproject.toml.
-By default this key is set to "true"; simply changing it to "false" will disable all Cython functionality.
+By default this key is set to ``true``; simply changing it to ``false`` will disable all Cython functionality.
 
 Supported Event Loops
 ^^^^^^^^^^^^^^^^^^^^^