vale errors

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

@@ -86,7 +86,7 @@ The following code example shows how to perform the preceding steps:
 You can also create a ``MongoClientSettings`` object from a connection string by calling the
 ``MongoClientSettings.FromConnectionString()`` method and passing the connection string,
 as shown in the following example. This is useful if you already have a connection string
-but want to modify some settings programmatically, or if you want to specify settings
+but want to modify some settings programmatically, or if you must specify settings
 that aren't available in the connection string.
 
 .. literalinclude:: /includes/fundamentals/code-examples/connection/ConnectionOptions.cs
@@ -133,6 +133,10 @@ this process:
 Connection Options
 ------------------
 
+The following sections describe the connection options available in the
+{+driver-short+} and how to specify them by using a ``MongoClientSettings`` or
+``MongoUrlBuilder`` object.
+
 .. _csharp-replica-set-options:
 
 Replica Set Options

source/connect/connection-options/stable-api.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-troubleshooting.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/crud/gridfs.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/insert.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/query/query-filter.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/data-formats/bson.txt

@@ -95,8 +95,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()``. 
 

source/data-formats/custom-types/class-mapping.txt

@@ -21,8 +21,8 @@ Overview
 --------
 
 In this guide, you can learn how to customize the way the {+driver-long+}
-maps BSON documents to and from {+language+} classes. You should read this page
-to learn more about the default class mapping behavior, or if you need to
+maps BSON documents to and from {+language+} classes. Read this page
+to learn more about the default class mapping behavior, or if you must 
 customize the way the driver serializes or deserializes your data.
 
 Automatic Class Mapping
@@ -35,7 +35,7 @@ the name of the field in the document to the name of the property in the class.
 
 .. important::
 
-   The type of the property in your class should match the type of the field in
+   Match the type of the property in your class to the type of the field in
    the document. The {+driver-short+} instantiates a serializer based on the
    type of the property in your class. If the types don't match when the driver
    attempts to deserialize the data, the serializer throws an exception.
@@ -72,7 +72,7 @@ class:
 .. important::
 
    You must register a class map *before* it's needed in your code. We recommend
-   registering class maps prior to initializing a connection with MongoDB.
+   registering class maps before initializing a connection with MongoDB.
 
 You can also manually map a subset of class properties, while still
 allowing the driver to automatically map the remaining properties. To do this, 
@@ -241,11 +241,11 @@ You can also support extra elements when initializing a class map as follows:
 Dynamically Serialize Properties
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can use a method to determine whether or not to serialize a property. For
+You can use a method to determine whether to serialize a property. For
 the driver to automatically use the method when serializing, you must prefix the
 method name with ``ShouldSerialize`` followed by the name of the property that
 the method applies to. When the driver sees a method with this naming
-convention, it uses that method to determine whether or not to serialize
+convention, it uses that method to determine whether to serialize
 properties that have the provided property name.
 
 The following example creates a method that only serializes the ``Age`` property