(DOCSP-19933) Improve and standardize intro text for drivers (#788)

Author: zach-carr

source/c.txt

@@ -17,12 +17,11 @@ MongoDB C Driver
 Introduction
 ------------
 
-The MongoDB C Driver, also known as “libmongoc”, is the official client library
-for C applications, and provides a base for MongoDB drivers in higher-level
-languages.
-
-The library is compatible with all major platforms. It depends on libbson
-to create and parse BSON data.
+Welcome to the documentation site for the official MongoDB C driver. 
+You can add the driver to your application to work with MongoDB in C. 
+Download the required libraries, ``libmongoc`` and ``libbson``,  from 
+`mongoc.org <https://mongoc.org/libmongoc/current/installing.html>`__ 
+or set up a runnable project by following our tutorial.
 
 - `Tutorial <http://mongoc.org/libmongoc/current/tutorial.html>`__
 

source/csharp.txt

@@ -17,8 +17,10 @@ MongoDB C#/.NET Driver
 Introduction
 ------------
 
-The official MongoDB C#/.NET Driver provides asynchronous interaction
-with MongoDB.
+Welcome to the documentation site for the official MongoDB C#/.NET 
+driver. You can add the driver to your application to work with MongoDB 
+in C#/.NET. Download it using `NuGet <https://www.nuget.org/>`__ or 
+set up a runnable project by following our Getting Started guide.
 
 - `Getting Started <{+csharp-docs-versioned+}/getting_started/>`__
 

source/cxx.txt

@@ -17,8 +17,11 @@ MongoDB C++ Driver
 Introduction
 ------------
 
-The MongoDB C++ Driver is the official client library for C++ applications
-using the C++11 (or later) standard.
+Welcome to the documentation site for the official MongoDB C++ driver. 
+You can add the driver to your application to work with MongoDB using 
+the C++11 or later standard. Download the library, ``mongocxx``,  
+from `mongocxx.org <http://mongocxx.org/mongocxx-v3/installation/>`__ 
+or set up a runnable project by following our tutorial.
 
 - `Tutorial <http://mongocxx.org/mongocxx-v3/tutorial/>`__
 

source/java-drivers.txt

@@ -20,11 +20,16 @@ Java MongoDB Drivers
 Introduction
 ------------
 
-`Java Driver <https://docs.mongodb.com/drivers/java/sync/current>`__ is the recommended MongoDB Java Driver.
-
-For asynchronous stream processing and reactive streams interoperability,
-the :doc:`Reactive Streams Driver </reactive-streams>` is the
-recommended MongoDB Java Driver.
+Welcome to the documentation site for the official MongoDB Java 
+drivers. You can add one of the following drivers to your application 
+to work with MongoDB in Java:
+
+- Use the 
+  `Java Driver <https://docs.mongodb.com/drivers/java/sync/current>`__ 
+  for synchronous Java applications.
+  
+- Use the :doc:`Reactive Streams Driver </reactive-streams>` to use the 
+  Reactive Streams API for asynchronous stream processing.
 
 Take the free online course taught by MongoDB
 ---------------------------------------------

source/motor.txt

@@ -17,15 +17,16 @@ Motor (Async Driver)
 Introduction
 ------------
 
-**Motor** is the recommended asynchronous Python driver for MongoDB.
-It is compatible with `Tornado <http://www.tornadoweb.org/>`__ and
-`asyncio <https://docs.python.org/3/library/asyncio.html>`__. We recommend
-that you use this driver if you need to run asynchronous operations. If
-you do not need to access MongoDB in a non-blocking manner or from
-co-routines, we recommend that you use the :doc:`PyMongo </pymongo>`
-driver instead.
-
-Follow the links below to learn more about how to use the Motor driver:
+Welcome to the documentation site for Motor, the official MongoDB 
+driver for asynchronous Python applications. Download it using 
+`pip <https://pypi.python.org/pypi/pip>`__
+or set up a runnable project by following our tutorials.
+
+.. tip::
+
+   If you do not need to access MongoDB in a non-blocking manner or from
+   co-routines, we recommend that you use the :doc:`PyMongo </pymongo>`
+   driver instead.
 
 - `Tutorial on using Motor with Tornado <http://motor.readthedocs.org/en/stable/tutorial-tornado.html>`__
 

source/php.txt

@@ -23,15 +23,23 @@ MongoDB PHP Driver
 Introduction
 ------------
 
-The PHP driver consists of two components, the MongoDB `extension <https://github.com/mongodb/mongo-php-driver>`_
-and `library <https://docs.mongodb.com/php-library/current>`_.
-
-The extension provides a low-level API and mainly serves to integrate
-`libmongoc and libbson <https://docs.mongodb.com/drivers/c/>`_ with PHP.
-
-While it is possible to use the extension alone, users are strongly encouraged
-to use the extension and library together. The library provides a high-level API
-consistent with other MongoDB language drivers.
+Welcome to the documentation site for the official MongoDB PHP driver. 
+You can add the driver to your application to work with MongoDB in PHP. 
+The MongoDB PHP Driver consists of the two following components:
+
+- The `extension <https://github.com/mongodb/mongo-php-driver>`_, which 
+  provides a low-level API and mainly serves to integrate 
+  `libmongoc and libbson <https://docs.mongodb.com/drivers/c/>`_ with 
+  PHP.
+
+- The `library <https://docs.mongodb.com/php-library/current>`_, which 
+  provides a high-level API for working with MongoDB 
+  databases consistent with other MongoDB language drivers.
+
+While it is possible to use the extension alone, MongoDB recommends 
+using both the extension and the library together. Download the 
+components you need or set up a runnable project by following our 
+tutorials.
 
 - `Tutorials <https://docs.mongodb.com/php-library/current/tutorial>`__
 

source/pymongo.txt

@@ -15,15 +15,19 @@ PyMongo
 Introduction
 ------------
 
-**PyMongo** is the official MongoDB Python driver for MongoDB. We
-recommend you use this driver to work with MongoDB from Python. If you
-need to access MongoDB in a non-blocking manner or from co-routines, we
-recommend that you use the :doc:`Motor </motor>` driver instead.
+Welcome to the documentation site for PyMongo, the official MongoDB 
+driver for synchronous Python applications. Download it using 
+`pip <https://pypi.python.org/pypi/pip>`__
+or set up a runnable project by following our tutorial.
 
-Follow the links below to learn more about how to use the PyMongo driver:
+.. tip::
 
-- `Tutorial <https://pymongo.readthedocs.io/en/stable/tutorial.html>`__ on
-  how to connect to MongoDB and run common operations.
+   If you need to access MongoDB in a non-blocking manner or from 
+   co-routines, we recommend that you use the :doc:`Motor </motor>` 
+   driver instead.
+
+- `Tutorial <https://pymongo.readthedocs.io/en/stable/tutorial.html>`__ 
+  on how to connect to MongoDB and run common operations.
 
 - `API Reference <https://pymongo.readthedocs.io/en/stable/api/index.html>`__
 
@@ -36,12 +40,12 @@ Follow the links below to learn more about how to use the PyMongo driver:
 Installation
 ------------
 
-You must install the PyMongo driver module to make it available to your Python
-application. We recommend using `pip <http://pypi.python.org/pypi/pip>`__
-to install PyMongo.
+You must install the PyMongo driver module to make it available to your 
+Python application. We recommend using 
+`pip <http://pypi.python.org/pypi/pip>`__ to install PyMongo.
 
-The following command demonstrates how you can install the latest version of
-the module using the command line:
+The following command demonstrates how you can install the latest 
+version of the module using the command line:
 
 .. code-block:: sh
 

source/python.txt

@@ -23,14 +23,12 @@ MongoDB Python Drivers
 Introduction
 ------------
 
-You can access MongoDB from your Python application using one of our
-official MongoDB Python drivers. Follow the links below to get started
-with each driver:
+Welcome to the documentation site for the official MongoDB Python 
+drivers. You can add one of the following drivers to your application 
+to work with MongoDB in Python:
 
-- :doc:`PyMongo </pymongo>` is the recommended driver to work with MongoDB
-  using Python.
-- :doc:`Motor </motor>` is the recommended driver for when you need
-  non-blocking access to MongoDB using Python.
+- Use :doc:`PyMongo </pymongo>` for synchronous Python applications.
 
-.. include:: /includes/university-m220p.rst
+- Use :doc:`Motor </motor>` for asynchronous Python applications.
 
+.. include:: /includes/university-m220p.rst

source/reactive-streams.txt

@@ -15,8 +15,11 @@ MongoDB Java Reactive Streams
 Introduction
 ------------
 
-**Java Reactive Streams** is an official Java driver for MongoDB and is the
-recommended driver for working with reactive streams in the JVM ecosystem.
+Welcome to the documentation site for the Reactive Streams Driver, the 
+official MongoDB driver for asynchronous Java applications. Download 
+it by following the 
+:java-docs:`Installation Guide <driver-reactive/getting-started/installation/>` 
+or set up a runnable project by following our tutorials.
 
 - :java-docs:`Reference Documentation <driver-reactive/>`
 

source/rust.txt

@@ -17,7 +17,10 @@ MongoDB Rust Driver
 Introduction
 ------------
 
-This is the official MongoDB Rust Driver.
+Welcome to the documentation site for the official MongoDB Rust driver. 
+You can add the driver to your application to work with MongoDB in 
+Rust. Download it from `crates.io <https://crates.io/crates/mongodb>`__ 
+or set up a runnable project with examples from our Usage Guide.
 
 - `Usage Guide <https://github.com/mongodb/mongo-rust-driver#example-usage>`__