diff --git a/source/auth/auth.md b/source/auth/auth.md index 04a83d758c..ec6c8b0164 100644 --- a/source/auth/auth.md +++ b/source/auth/auth.md @@ -855,7 +855,7 @@ The following diagram is a summary of the steps drivers MUST follow to calculate | X-Amz-Date\* | See [Amazon Documentation](https://docs.aws.amazon.com/general/latest/gr/sigv4_elements.html) | | X-Amz-Security-Token\* | Optional, see [Amazon Documentation](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html?shortFooter=true) | | X-MongoDB-Server-Nonce\* | Base64 string of server nonce | -| X-MongoDB-GS2-CB-Flag\* | ASCII lower-case character "n" or "y" or "p" | +| X-MongoDB-GS2-CB-Flag\* | ASCII lower-case character 'n' or 'y' or 'p' | | X-MongoDB-Optional-Data\* | Optional data, base64 encoded representation of the optional object provided by the client | | Body | Action=GetCallerIdentity&Version=2011-06-15 | diff --git a/source/bson-decimal128/decimal128.md b/source/bson-decimal128/decimal128.md index 5bf1edcfe2..488896f16e 100644 --- a/source/bson-decimal128/decimal128.md +++ b/source/bson-decimal128/decimal128.md @@ -38,7 +38,7 @@ of precision, a max value of approximately `10^6145`, and min value of approxima `BSON Decimal128` type (`"\x13"`). **Clamping**:\ -Clamping happens when a value"s exponent is too large for the destination format. This works by adding +Clamping happens when a value's exponent is too large for the destination format. This works by adding zeros to the coefficient to reduce the exponent to the largest usable value. An overflow occurs if the number of digits required is more than allowed in the destination format. @@ -164,40 +164,40 @@ number or a special value. * If it describes a finite number, it includes one or more decimal digits, with an optional decimal point. The decimal point may be embedded in the digits, or may be prefixed or suffixed to them. The group of digits (and - optional point) thus constructed may have an optional sign ("+" or "-") + optional point) thus constructed may have an optional sign ('+' or '-') which must come before any digits or decimal point. -* The string thus described may optionally be followed by an "E" +* The string thus described may optionally be followed by an 'E' (indicating an exponential part), an optional sign, and an integer following the sign that represents a power of ten that is to be applied. - The "E" may be in uppercase or lowercase. + The 'E' may be in uppercase or lowercase. * If it describes a special value, it is one of the case-independent names - "Infinity", "Inf", or "NaN" (where the first two represent infinity and + 'Infinity', 'Inf', or 'NaN' (where the first two represent infinity and the second represent NaN). The name may be preceded by an optional sign, as for finite numbers. * No blanks or other whitespace characters are permitted in a numeric string. Formally - sign ::= "+" | "-" - digit ::= "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | - "8" | "9" - indicator ::= "e" | "E" + sign ::= '+' | '-' + digit ::= '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | + '8' | '9' + indicator ::= 'e' | 'E' digits ::= digit [digit]... - decimal-part ::= digits "." [digits] | ["."] digits + decimal-part ::= digits '.' [digits] | ['.'] digits exponent-part ::= indicator [sign] digits - infinity ::= "Infinity" | "Inf" - nan ::= "NaN" + infinity ::= 'Infinity' | 'Inf' + nan ::= 'NaN' numeric-value ::= decimal-part [exponent-part] | infinity numeric-string ::= [sign] numeric-value | [sign] nan -where the characters in the strings accepted for "infinity" and "nan" may be in +where the characters in the strings accepted for 'infinity' and 'nan' may be in any case. If an implementation supports the concept of diagnostic information on NaNs, the numeric strings for NaNs MAY include one or more digits, as shown above.[3] These digits encode the diagnostic information in an implementation-defined manner; however, conversions to and from string for diagnostic NaNs should be reversible if possible. If an implementation does not support diagnostic information on NaNs, these digits should be ignored where -necessary. A plain "NaN" is usually the same as "NaN0". +necessary. A plain 'NaN' is usually the same as 'NaN0'. Drivers MAY choose to support signed NaN (sNaN), along with sNaN with @@ -249,9 +249,9 @@ greater than or equal to -6, the number will be converted to a character form without using exponential notation. In this case, if the exponent is zero then no decimal point is added. Otherwise (the exponent will be negative), a decimal point will be inserted with the absolute value of the exponent specifying the -number of characters to the right of the decimal point. "0" characters are +number of characters to the right of the decimal point. '0' characters are added to the left of the converted coefficient as necessary. If no character -precedes the decimal point after this insertion then a conventional "0" +precedes the decimal point after this insertion then a conventional '0' character is prefixed. @@ -260,10 +260,10 @@ less than -6), the number will be converted to a character form using exponential notation. In this case, if the converted coefficient has more than one digit a decimal point is inserted after the first digit. An exponent in character form is then suffixed to the converted coefficient (perhaps with -inserted decimal point); this comprises the letter "E" followed immediately by +inserted decimal point); this comprises the letter 'E' followed immediately by the adjusted exponent converted to a character form. The latter is in base ten, using the characters 0 through 9 with no leading zeros, always prefixed by a -sign character ("-" if the calculated exponent is negative, "+" otherwise). +sign character ('-' if the calculated exponent is negative, '+' otherwise). ``` This corresponds to the following code snippet: @@ -334,10 +334,10 @@ Most of the tests are converted from the ## Q&A -- Is it true Decimal128 doesn"t normalize the value? +- Is it true Decimal128 doesn't normalize the value? - Yes. As a result of non-normalization rules of the Decimal128 data type, precision is represented exactly. For - example, "2.00" always remains stored as 200E-2 in Decimal128, and it differs from the representation of "2.0" + example, '2.00' always remains stored as 200E-2 in Decimal128, and it differs from the representation of '2.0' (20E-1). These two values compare equally, but represent different ideas. - How does Decimal128 "2.000" look in the shell? diff --git a/source/change-streams/change-streams.md b/source/change-streams/change-streams.md index 7d001186ac..6fe99282e4 100644 --- a/source/change-streams/change-streams.md +++ b/source/change-streams/change-streams.md @@ -138,18 +138,18 @@ class ChangeStreamDocument { operationDescription: Optional /** - * Only present for ops of type "insert", "update", "replace", and - * "delete". + * Only present for ops of type 'insert', 'update', 'replace', and + * 'delete'. * * For unsharded collections this contains a single field, _id, with the * value of the _id of the document updated. For sharded collections, * this will contain all the components of the shard key in order, - * followed by the _id if the _id isn"t part of the shard key. + * followed by the _id if the _id isn't part of the shard key. */ documentKey: Optional; /** - * Only present for ops of type "update". + * Only present for ops of type 'update'. */ updateDescription: Optional; @@ -257,7 +257,7 @@ class UpdateDescription { /** * Truncations of arrays may be reported using one of the following methods: - * either via this field or via the "updatedFields" field. In the latter case the entire array is considered to be replaced. + * either via this field or via the 'updatedFields' field. In the latter case the entire array is considered to be replaced. * * The structure of documents in this field is * { @@ -556,7 +556,7 @@ in the pipeline supplied to the helper), as the server will return an error. The helper methods MUST determine a read concern for the operation in accordance with the [Read and Write Concern specification](https://github.com/mongodb/specifications/blob/master/source/read-write-concern/read-write-concern.rst#via-code). -The initial implementation of change streams on the server requires a "majority" read concern or no read concern. +The initial implementation of change streams on the server requires a 'majority' read concern or no read concern. Drivers MUST document this requirement. Drivers SHALL NOT throw an exception if any other read concern is specified, but instead should depend on the server to return an error.