DOCSP-49868 - MongoUrl (#629)

Author: mongoKart

config/intersphinx.yaml

@@ -1,4 +1,4 @@
-# Weirdly, giza wants a non-empty list of two or more, so we have to include extraneous/unused one --hence the python
+# Weirdly, giza wants a non-empty list of two or more, so we must include extraneous/unused one --hence the python
 name: python
 url: https://docs.python.org/2/
 path: python2.inv

source/atlas-search.txt

@@ -122,7 +122,7 @@ Use the ``Compound()`` method to combine two or more operators into a single
 search.
 
 The following example searches the ``guitars`` collection for any documents
-that match all of the following criteria:
+that match all the following criteria:
 
 - The ``rating`` field exists on the document
 - The ``in_stock`` field is not ``false``

source/connect/connection-options.txt

@@ -12,13 +12,6 @@
    :depth: 2
    :class: singlecol
 
-.. note::
-
-   The {+stable-api+} feature requires {+mdb-server+} 5.0 or later.
-
-   You should use the {+stable-api+} feature only if all of the MongoDB
-   servers you're connecting to support this feature.
-
 Overview
 --------
 
@@ -46,10 +39,10 @@ version of the {+stable-api+}.
 .. tip::
 
    Once you've created a ``MongoClient``, you can't change its {+stable-api+} version.  
-   If you need to run commands using more than one version of the 
+   If you must run commands using more than one version of the 
    {+stable-api+}, instantiate a separate client with that version.
 
-   If you need to run commands not covered by the {+stable-api+}, make sure the
+   If you must run commands not covered by the {+stable-api+}, make sure the
    "strict" option is disabled. See the section on
    :ref:`{+stable-api+} Options <stable-api-options>` for more information.
 

source/connect/connection-options/stable-api.txt

@@ -168,7 +168,7 @@ You can also set configuration settings by creating a ``MongoClientSettings``
 object and passing that to the ``MongoClient`` constructor. You can use the
 ``Credential`` property to set the login credentials including specifying the
 authentication database. For more information about using ``MongoClientSettings``
-as well as some examples, see
+and to see some examples, see
 :ref:`Using MongoClientSettings <csharp-mongo-client-settings>`.
 
 You can check if this is the issue by attempting to connect to a MongoDB
@@ -249,7 +249,7 @@ The following section describes a method that may help resolve the issue.
 Check the Number of Connections
 -------------------------------
 
-If you need to create more open connections, increase ``MaxConnectionPoolSize``. For more
+If you must create more open connections, increase ``MaxConnectionPoolSize``. For more
 information about checking the number of connections, see
 :ref:`Check the Number of Connections <csharp-troubleshooting-connection-number-connections>`
 in the Error Sending Message section.
@@ -279,7 +279,7 @@ time the driver spends attempting to establish the connection by using the
 :manual:`Timeout Options </reference/connection-string/#timeout-options>` in
 the Server manual.
 
-You should ensure the ``connectTimeoutMS`` setting is not lower than
+Ensure the ``connectTimeoutMS`` setting is not lower than
 the highest network latency you have to a member of the set. If one of the
 secondary members has a latency of 10000 milliseconds, setting the
 ``connectTimeoutMS`` to 9000 prevents the driver from ever connecting to that
@@ -301,7 +301,7 @@ You can set this option on the connection string. The following example sets
 
 You can also set configuration settings by creating a ``MongoClientSettings``
 object and passing that to the ``MongoClient`` constructor. For more information
-about using ``MongoClientSettings`` as well as some examples, see
+about using ``MongoClientSettings`` and to see some examples, see
 :ref:`Using MongoClientSettings <csharp-mongo-client-settings>`.
 
 Check the Number of Connections

source/connect/connection-troubleshooting.txt

@@ -97,20 +97,15 @@ connection URI to connect to a MongoDB deployment running on port ``27017`` of `
    const string uri = "mongodb://localhost:27017/";
    var client = new MongoClient(uri);
 
-Configure the MongoClient
--------------------------
+Configure the Connection
+------------------------
 
-You can configure settings for the ``MongoClient`` object by passing a
-``MongoClientSettings`` object to the constructor. The following example creates a
-``MongoClient`` object and sets the ``UseTls`` property to ``true``:
+You can configure your connection in the following ways:
 
-.. code-block:: csharp
-
-   var connectionString = "mongodb://localhost:27017/"
-   var settings = MongoClientSettings.FromConnectionString(connectionString);
-   settings.UseTls = true;
+- Specifying parameters in the connection URI
+- Specifying settings on a ``MongoClientSettings`` or ``MongoUrlBuilder`` object
 
-To view a full list of the settings you can configure, see the
+To learn more about configuring your connection, see the
 :ref:`csharp-connection-options` guide.
 
 API Documentation

source/connect/mongoclient.txt

@@ -690,7 +690,7 @@ code.
 .. note:: File Revisions
 
    The ``Delete()`` and ``DeleteAsync()`` methods support deleting only one file at a time.
-   If you want to delete each file revision, or files with different upload
+   To delete each file revision, or files with different upload
    times that share the same file name, collect the ``_id`` values of each revision.
    Then, pass each ``_id`` value in separate calls to the ``Delete()`` or ``DeleteAsync()``
    method.

source/crud/gridfs.txt

@@ -248,10 +248,8 @@ Assume you want to insert the following documents:
 
 If you attempt to insert these documents with default
 ``InsertManyOptions``, the driver throws a ``MongoBulkWriteException`` at the third
-document because of the repeated ``_id`` value, but the documents before
-the error-producing document are still inserted into your collection.
-
-If you look inside your collection, you should be able to see the following documents:
+document because of the repeated ``_id`` value. The operation adds only the first two documents
+to the collection:
 
 .. code-block:: json
    :copyable: false
@@ -262,9 +260,7 @@ If you look inside your collection, you should be able to see the following docu
 If you set ``IsOrdered`` to ``false`` in your insert operation, the driver will
 continue to insert your documents even if some documents produce errors.
 With this modified insert behavior, the driver throws an exception but inserts all documents
-that do not produce errors.
-
-If you look inside your collection, you should be able to see the following documents:
+that do not produce errors:
 
 .. code-block:: json
    :copyable: false

source/crud/insert.txt

@@ -586,12 +586,12 @@ bitwise operations and the equivalent {+mdb-server+} operators:
      - {+mdb-server+} Operator
 
    * - ``BitsAllClear()``
-     - Matches documents where all of the specified bit positions are clear (``0``) in
+     - Matches documents where all the specified bit positions are clear (``0``) in
        the specified field.
      - :manual:`$bitsAllClear </reference/operator/query/bitsAllClear/>`
 
    * - ``BitsAllSet()``
-     - Matches documents where all of the specified bit positions are set (``1``) in
+     - Matches documents where all the specified bit positions are set (``1``) in
        the specified field.
      - :manual:`$bitsAllSet </reference/operator/query/bitsAllSet/>`
 

source/crud/query/query-filter.txt

@@ -99,8 +99,8 @@ write to a file, perform the following steps:
 #. For each BSON document and subdocument you want to create, call 
    ``WriteStartDocument()``.
 #. Within each BSON document and subdocument, call ``WriteName()`` to set the field
-   name and the appropriate ``Write*`` method to set its value. Each data type has a 
-   dedicated ``Write*`` method that you should use.
+   name and the appropriate ``Write*`` method to set its value. Use the
+   dedicated ``Write*`` method that corresponds to each data type.
 #. To start and end arrays, use ``WriteStartArray()`` and ``WriteEndArray()``.
 #. At the end of each document and subdocument, call ``WriteEndDocument()``.