rm review

Author: mongoKart

source/includes/collation.rst

@@ -24,87 +24,94 @@ setting's value.
        | **Data Type**: {+string-data-type+} 
      - ``Locale`` 
 
-   * - ``alternate``
-     - | Optional. Specifies whether the driver considers whitespace and punctuation as base
-         characters for purposes of comparison.
+   * - ``caseLevel``
+     - | *(Optional)* Specifies whether to include case comparison.
        |
-       | **Data Type**: `CollationAlternate <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.CollationAlternate.html>`__
-       | **Default**: ``CollationAlternate.NonIgnorable`` (spaces and punctuation are
-         considered base characters)
-     - ``Alternate``
-
-   * - ``backwards``
-     - | Optional. Specifies whether strings containing diacritics sort from the back of the string
-         to the front.
+       | When this argument is ``true``, the driver's behavior depends on the value of
+         the ``strength`` argument:
+       |
+       | - If ``strength`` is ``CollationStrength.Primary``, the driver compares base
+           characters and case.
+       | - If ``strength`` is ``CollationStrength.Secondary``, the driver compares base
+           characters, diacritics, other secondary differences, and case.
+       | - If ``strength`` is any other value, this argument is ignored.
+       |
+       | When this argument is ``false``, the driver doesn't include case comparison at
+         strength level ``Primary`` or ``Secondary``.
        |
        | **Data Type**: {+bool-data-type+} 
        | **Default**: ``false``
-     - ``Backwards``
+     - ``CaseLevel``
 
    * - ``caseFirst``
-     - | Optional. Specifies the sort order of case differences during tertiary level comparisons.
+     - | *(Optional)* Specifies the sort order of case differences during tertiary level comparisons.
        |
        | **Data Type**: `CollationCaseFirst <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.CollationCaseFirst.html>`__
        | **Default**: ``CollationCaseFirst.Off``
      - ``CaseFirst``
 
-   * - ``caseLevel``
-     - | Optional. Specifies whether to include case comparison at strength level ``Primary`` or
-         ``Secondary``. 
-       |
-       | When this argument is ``true``:
+   * - ``strength``
+     - | *(Optional)* Specifies the level of comparison to perform, as defined in the
+         `ICU documentation <https://unicode-org.github.io/icu/userguide/collation/concepts.html#comparison-levels>`__.
        |
-       | - If the strength is ``Primary``, the driver compares base
-           characters and case.
-       | - If the strength is ``Secondary``, the driver compares base
-           characters, diacritics, other secondary differences, and case.
+       | **Data Type**: `CollationStrength <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.CollationStrength.html>`__
+       | **Default**: ``CollationStrength.Tertiary``
+     - ``Strength``
+
+   * - ``numericOrdering``
+     - | *(Optional)* Specifies whether the driver compares numeric strings as numbers.
+       | 
+       | If this argument is ``true``, the driver compares numeric strings as numbers.
+         For example, when comparing the strings "10" and "2", the driver treats the values
+         as 10 and 2, and finds 10 to be greater.
+       |  
+       | If this argument is ``false`` or excluded, the driver compares numeric strings
+         as strings. For example, when comparing the strings "10" and "2", the driver
+         compares one character at a time. Because "1" is less than "2", the driver finds
+         "10" to be less than "2".
        |
-       | When this argument is ``false``, the driver doesn't include case comparison at
-         strength level ``Primary`` or ``Secondary``.
+       | For more information, see :manual:`Collation Restrictions </reference/collation/#restrictions>`
+         in the {+mdb-server+} manual.
        |
-       | **Data Type**: {+bool-data-type+} 
+       | **Data Type**: {+bool-data-type+}
        | **Default**: ``false``
-     - ``CaseLevel``
+     - ``NumericOrdering``
+
+   * - ``alternate``
+     - | *(Optional)* Specifies whether the driver considers whitespace and punctuation as base
+         characters for purposes of comparison.
+       |
+       | **Data Type**: `CollationAlternate <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.CollationAlternate.html>`__
+       | **Default**: ``CollationAlternate.NonIgnorable`` (spaces and punctuation are
+         considered base characters)
+     - ``Alternate``
 
    * - ``maxVariable``
-     - | Optional. Specifies which characters the driver considers ignorable when
-         ``Alternate`` is ``CollationAlternate.Shifted``.
+     - | *(Optional)* Specifies which characters the driver considers ignorable when
+         the ``alternate`` argument is ``CollationAlternate.Shifted``.
        |
        | **Data Type**: `CollationMaxVariable <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.CollationMaxVariable.html>`__ 
        | **Default**: ``CollationMaxVariable.Punctuation`` (the driver ignores punctuation
          and spaces)
      - ``MaxVariable``
 
    * - ``normalization``
-     - | Optional. Specifies whether the driver normalizes text as needed.
+     - | *(Optional)* Specifies whether the driver normalizes text as needed.
        |
-       | Most text doesn't require normalization.
+       | Most text doesn't require normalization. For more information about
+         normalization, see the `ICU documentation <https://unicode-org.github.io/icu/userguide/collation/concepts.html#normalization>`__.
        |
        | **Data Type**: {+bool-data-type+}
        | **Default**: ``false``
      - ``Normalization``
 
-   * - ``numericOrdering``
-     - | Optional. Specifies whether the driver compares numeric strings as numbers.
-       | 
-       | If this argument is ``true``, the driver compares numeric strings as numbers.
-         For example, "10" is greater than "2". If this argument is ``false`` or excluded,
-         the driver compares numeric strings as strings. For example, "10" is less than "2".
-       |
-       | For more information, see :manual:`Collation Restrictions </reference/collation/#restrictions>`
-         in the {+mdb-server+} manual.
+   * - ``backwards``
+     - | *(Optional)* Specifies whether strings containing diacritics sort from the back of the string
+         to the front.
        |
-       | **Data Type**: {+bool-data-type+}
+       | **Data Type**: {+bool-data-type+} 
        | **Default**: ``false``
-     - ``NumericOrdering``
-
-   * - ``strength``
-     - | Optional. Specifies the level of comparison to perform, as defined in the
-         `ICU documentation <https://unicode-org.github.io/icu/userguide/collation/concepts.html#comparison-levels>`__.
-       |
-       | **Data Type**: `CollationStrength <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.CollationStrength.html>`__
-       | **Default**: ``CollationStrength.Tertiary``
-     - ``Strength``
+     - ``Backwards``
 
-For more information about collation, see the :manual:`Collation <reference/collation>`
+For more information about collation, see the :manual:`Collation </reference/collation>`
 page in the {+mdb-server+} manual.