ARROW-64 Improve Installation Instructions (#60)

Author: blink1073

bindings/python/docs/source/developer/installation.rst

@@ -37,14 +37,18 @@ PyMongoArrow uses `libbson <http://mongoc.org/libbson/current/index.html>`_.
 Detailed instructions for building/installing ``libbson`` can be found
 `here <http://mongoc.org/libmongoc/1.17.5/installing.html#installing-the-mongodb-c-driver-libmongoc-and-bson-library-libbson>`_.
 
-On macOS, users can install the latest ``libbson`` via Homebrew::
+You can either use a system-provided version of ``libbson`` that is properly
+configured for use with ``pkg-config``, or use the provided ``build-libbson.sh` ` script to build it::
 
-  $ brew install mongo-c-driver
+  $ LIBBSON_INSTALL_DIR=$(pwd)/libbson ./build-libbson.sh
 
-Alternatively, you can use the provided `build-libbson.sh` script to build it::
+On macOS, users can install the latest ``libbson`` using Homebrew::
 
-  $ LIBBSON_INSTALL_DIR=$(pwd)/libbson ./build-libbson.sh
+  $ brew install mongo-c-driver
+
+Conda users can install ``libbson`` as follows::
 
+  $ conda install --channel conda-forge libbson pkg-config
 
 Build
 -----

bindings/python/docs/source/installation.rst

@@ -30,15 +30,24 @@ To upgrade using pip::
 
   $ python -m pip install --upgrade pymongoarrow
 
-.. attention:: Installing PyMongoArrow from
-   `wheels <https://www.python.org/dev/peps/pep-0427/>`_ on macOS Big Sur
-   requires ``pip`` >= 20.3. To upgrade ``pip`` run::
+.. attention:: 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::
 
      $ python -m pip install --upgrade pip
 
-   We currently distribute wheels for macOS and Linux on x86_64
+   You can then attempt to re-install ``pymongoarrow``.
+
+   We currently distribute wheels for macOS, Windows, and Linux on x86_64
    architectures.
 
+**PyMongoArrow** is also available for ``conda`` users by running::
+
+  $ conda install --channel conda-forge pymongoarrow
+
+
+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`.
+
 
 Dependencies
 ^^^^^^^^^^^^