DOCSP-37418 Clean up Installation (#8)

Author: jordan-smith721

source/installation.txt

@@ -4,89 +4,124 @@
 Installing and Upgrading
 ========================
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: setup, download, update
+
 In this guide, you can learn how to install and upgrade {+driver-short+}.
 
 System Compatibility
 --------------------
 
-PyMongoArrow is regularly built and tested on macOS and Linux
+{+driver-short+} is regularly built and tested on macOS and Linux
 (Ubuntu 20.04).
 
 Python Compatibility
 --------------------
 
-PyMongoArrow is compatible with CPython 3.8, 3.9, 3.10, and 3.11.
+{+driver-short+} is compatible with CPython versions 3.8, 3.9, 3.10, and 3.11.
 
 Installation
 ------------
 
-**PyMongoArrow** can be installed in three ways: via Pip, Conda, or Source.
+You can install **{+driver-short+}** in three ways:
+
+- Pip 
+- Conda
+- From source
+
+Install with Pip
+~~~~~~~~~~~~~~~~
 
+We recommend using pip to install {+driver-short+} on all platforms.
+{+driver-short+} is available on `PyPI <http://pypi.python.org/pypi/pymongo/>`_.
 
-**Using Pip.** We recommend using pip to install pymongoarrow on all platforms.
-PyMongoArrow is available on
-`PyPI <http://pypi.python.org/pypi/pymongo/>`_.
+.. code-block:: sh
 
-  $ python -m pip install pymongoarrow
+   $ python -m pip install pymongoarrow
 
-To get a specific version of pymongo::
+To get a specific version of pymongo:
 
-  $ python -m pip install pymongoarrow==0.1.1
+.. code-block:: sh
 
-To upgrade using pip::
+   $ python -m pip install pymongoarrow==0.1.1
 
-  $ python -m pip install --upgrade pymongoarrow
+To upgrade using pip:
+
+.. code-block:: sh
+   
+   $ python -m pip install --upgrade pymongoarrow
 
 .. important:: 
 
-   If the install fails due to an error like ``ValueError: Could
-   not find "libbson-1.0" library`` it means that ``pip`` failed to find a
-   suitable wheel for your platform.  We recommend first ensuring you have
-   ``pip`` >= 20.3 installed. To upgrade ``pip`` run::
+   If the install fails because of an error, such as ``ValueError: Could
+   not find "libbson-1.0" library``, it means that ``pip`` failed to find a
+   suitable wheel for your platform. We recommend first ensuring you have
+   ``pip`` >= 20.3 installed. To upgrade ``pip``, run the following shell command:
 
    .. code-block:: python
 
       $ python -m pip install --upgrade pip
 
-   You can then attempt to re-install ``pymongoarrow``.
+You can then try to re-install ``pymongoarrow``.
+
+We currently distribute wheels for macOS, Windows, and Linux on x86_64
+architectures.
 
-   We currently distribute wheels for macOS, Windows, and Linux on x86_64
-   architectures.
+Install with Conda
+~~~~~~~~~~~~~~~~~~
 
-**Using Conda.** PyMongoArrow is available for ``conda`` users by running::
+PyMongoArrow is available for ``conda`` users by running the following shell
+command:
 
 .. code-block:: python
 
    $ conda install --channel conda-forge pymongoarrow
 
-**From Source.** If the above options still do not allow you to install ``pymongoarrow`` on your
-system, you will have to install from source, see :doc:`developer/installation`.
+Install from Source
+~~~~~~~~~~~~~~~~~~~
 
+If the above options still do not allow you to install ``pymongoarrow`` on your
+system, you can install from source. To learn how, see the `Developer Guide
+<https://mongo-arrow.readthedocs.io/en/{+patch-version-number+}/developer/installation.html>`__.
 
 Dependencies
 ^^^^^^^^^^^^
 
-PyMongoArrow requires:
+{+driver-short+} requires the following:
 
 - PyMongo>=4.4
 - PyArrow>=13,<13.1
 
-To use PyMongoArrow with a PyMongo feature that requires an optional
-dependency, users must install PyMongo with the given dependency manually.
+To use {+driver-short+} with a PyMongo feature that requires an optional
+dependency, users must install PyMongo with the dependency manually.
 
 .. note:: 
 
    PyMongo's optional dependencies are detailed
-   `here <https://pymongo.readthedocs.io/en/stable/installation.html#dependencies>`_.
+   `here <https://pymongo.readthedocs.io/en/stable/installation.html#dependencies>`__.
+
+For example, to use {+driver-short+} with Client-Side Field Level Encryption,
+you must install PyMongo with the ``encryption`` option in addition to installing
+{+driver-short+}:
+
+.. code-block:: sh
 
-For example, to use PyMongoArrow with Client-Side Field Level Encryption
-users must install PyMongo with the ``encryption`` extra in addition to installing
-PyMongoArrow::
+   $ python -m pip install 'pymongo[encryption]' pymongoarrow
 
-  $ python -m pip install 'pymongo[encryption]' pymongoarrow
+Applications intending to use {+driver-short+} APIs that return query result-sets
+as ``pandas.DataFrame`` instances, such as ``~pymongoarrow.api.find_pandas_all()``,
+must also have ``pandas`` installed:
 
-Applications intending to use PyMongoArrow APIs that return query result sets
-as :class:`pandas.DataFrame` instances (e.g. :meth:`~pymongoarrow.api.find_pandas_all`)
-must also have ``pandas`` installed::
+.. code-block:: sh
 
-  $ python -m pip install pandas
+   $ python -m pip install pandas