Skip to content

Commit 78d743f

Browse files
authored
DOCSP-50027: reduce EOL server mentions (#190)
1 parent d372a03 commit 78d743f

File tree

8 files changed

+48
-117
lines changed

8 files changed

+48
-117
lines changed

source/fundamentals/authentication.txt

Lines changed: 23 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -64,43 +64,36 @@ password to authenticate to a server.
6464

6565
MongoDB supports the following SCRAM-based authentication mechanisms:
6666

67-
- :ref:`SCRAM-SHA-256 <rust-auth-scramsha256>`: an authentication mechanism that
67+
- :ref:`SCRAM-SHA-256 <rust-auth-scramsha256>`: An authentication mechanism that
6868
uses your database username and password, encrypted with the ``SHA-256``
69-
algorithm
70-
- :ref:`SCRAM-SHA-1 <rust-auth-scramsha1>`: an authentication mechanism that
69+
algorithm. This is the default authentication mechanism.
70+
- :ref:`SCRAM-SHA-1 <rust-auth-scramsha1>`: An authentication mechanism that
7171
uses your database username and password, encrypted with the ``SHA-1``
72-
algorithm
72+
algorithm.
7373

74-
.. important:: Default Authentication Mechanism
75-
76-
If you do not specify an authentication mechanism, the server
77-
attempts to validate credentials by using the default authentication
78-
mechanism, a SCRAM-based mechanism that varies depending on the
79-
version of the server that you are connecting to.
80-
81-
The ``SCRAM-SHA-256`` mechanism is the default authentication
82-
mechanism for MongoDB Server versions 4.0 and later.
74+
.. _rust-auth-scramsha256:
8375

84-
To use the default authentication mechanism, omit only the
85-
``mechanism`` field when you instantiate your ``Credential`` struct.
86-
This example uses the following placeholders:
76+
SCRAM-SHA-256
77+
~~~~~~~~~~~~~
8778

88-
- ``db_username``: Your database username
89-
- ``db_password``: Your database password
90-
- ``db``: The authentication database associated with the user
79+
Since ``SCRAM-SHA-256`` is the default authentication mechanism,
80+
you can omit the ``mechanism`` field when you instantiate your ``Credential`` struct
81+
to use this mechanism.
9182

92-
.. literalinclude:: /includes/fundamentals/code-snippets/auth.rs
93-
:language: rust
94-
:dedent:
95-
:start-after: start-default
96-
:end-before: end-default
83+
This example specifies the default authentication mechanism by using
84+
the following placeholders:
9785

98-
.. _rust-auth-scramsha256:
86+
- ``db_username``: Your database username
87+
- ``db_password``: Your database password
88+
- ``db``: The authentication database associated with the user
9989

100-
SCRAM-SHA-256
101-
~~~~~~~~~~~~~
90+
.. literalinclude:: /includes/fundamentals/code-snippets/auth.rs
91+
:language: rust
92+
:dedent:
93+
:start-after: start-default
94+
:end-before: end-default
10295

103-
To specify the ``SCRAM-SHA-256`` authentication mechanism, set the
96+
To explicitly specify the ``SCRAM-SHA-256`` authentication mechanism, set the
10497
``mechanism`` field of your ``Credential`` struct to
10598
``AuthMechanism::ScramSha256``. This example specifies the
10699
authentication mechanism by using the following placeholders:
@@ -160,11 +153,8 @@ feature flag to your ``mongodb`` dependency in your project's
160153
.. important::
161154

162155
To use the ``MONGODB-AWS`` authentication mechanism in the
163-
{+driver-short+}, your application must meet the following
164-
requirements:
165-
166-
- You are connected to MongoDB Server version 4.4 or later.
167-
- You are using the ``tokio`` asynchronous runtime.
156+
{+driver-short+}, your application must use the ``tokio``
157+
asynchronous runtime.
168158

169159
The driver obtains the credentials only from the first source in which
170160
they are found. The driver checks for your credentials from the following

source/fundamentals/connections/network-compression.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,9 @@ the total amount of data passed over the network.
2525

2626
The driver supports the following compressors:
2727

28-
1. `Snappy <https://google.github.io/snappy/>`__: available in MongoDB 3.4 and later
29-
#. `Zlib <https://zlib.net/>`__: available in MongoDB 3.6 and later
30-
#. `Zstandard <https://github.com/facebook/zstd/>`__: available in MongoDB 4.2 and later
28+
1. `Snappy <https://google.github.io/snappy/>`__
29+
#. `Zlib <https://zlib.net/>`__
30+
#. `Zstandard <https://github.com/facebook/zstd/>`__
3131

3232
.. note:: Compressor Selection
3333

source/fundamentals/crud/compound-operations.txt

Lines changed: 9 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -151,24 +151,21 @@ The following table describes the options available in
151151
* - ``hint``
152152
- | The index to use for the operation. To learn more about
153153
indexes, see :manual:`Indexes </indexes/>` in the Server
154-
manual. This option is available only when connecting to
155-
{+server+} versions 4.4 and later.
154+
manual.
156155
|
157156
| Type: ``Hint``
158157
| Default: ``None``
159158

160159
* - ``let_vars``
161160
- | A map of parameters and values. You can access these parameters
162-
as variables in aggregation expressions. This option is available
163-
only when connecting to {+server+} versions 5.0 and later.
161+
as variables in aggregation expressions.
164162
|
165163
| Type: ``Document``
166164

167165
* - ``comment``
168166
- | An arbitrary ``Bson`` value tied to the operation to trace
169167
it through the database profiler, ``currentOp``, and
170-
logs. This option is available only when connecting to
171-
{+server+} versions 4.4 and later.
168+
logs.
172169
|
173170
| Type: ``Bson``
174171
| Default: ``None``
@@ -319,24 +316,21 @@ The following table describes the options available in
319316
* - ``hint``
320317
- | The index to use for the operation. To learn more about
321318
indexes, see :manual:`Indexes </indexes/>` in the Server
322-
manual. This option is available only when connecting to
323-
{+server+} versions 4.4 and later.
319+
manual.
324320
|
325321
| Type: ``Hint``
326322
| Default: ``None``
327323

328324
* - ``let_vars``
329325
- | A map of parameters and values. You can access these parameters
330-
as variables in aggregation expressions. This option is available
331-
only when connecting to {+server+} versions 5.0 and later.
326+
as variables in aggregation expressions.
332327
|
333328
| Type: ``Document``
334329

335330
* - ``comment``
336331
- | An arbitrary ``Bson`` value tied to the operation to trace
337332
it through the database profiler, ``currentOp``, and
338-
logs. This option is available only when connecting to
339-
{+server+} versions 4.4 and later.
333+
logs.
340334
|
341335
| Type: ``Bson``
342336
| Default: ``None``
@@ -482,24 +476,21 @@ The following table describes the options available in
482476
* - ``hint``
483477
- | The index to use for the operation. To learn more about
484478
indexes, see :manual:`Indexes </indexes/>` in the Server
485-
manual. This option is available only when connecting to
486-
{+server+} versions 4.4 and later.
479+
manual.
487480
|
488481
| Type: ``Hint``
489482
| Default: ``None``
490483

491484
* - ``let_vars``
492485
- | A map of parameters and values. You can access these parameters
493-
as variables in aggregation expressions. This option is available
494-
only when connecting to {+server+} versions 5.0 and later.
486+
as variables in aggregation expressions.
495487
|
496488
| Type: ``Document``
497489

498490
* - ``comment``
499491
- | An arbitrary ``Bson`` value tied to the operation to trace
500492
it through the database profiler, ``currentOp``, and
501-
logs. This option is available only when connecting to
502-
{+server+} versions 4.4 and later.
493+
logs.
503494
|
504495
| Type: ``Bson``
505496
| Default: ``None``

source/fundamentals/crud/write-operations/change.txt

Lines changed: 6 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -125,10 +125,9 @@ and descriptions </reference/operator/update-field/>`.
125125

126126
.. note:: Aggregation Pipelines in Update Operations
127127

128-
If you are using MongoDB Server version 4.2 or later, you can use aggregation
129-
pipelines in update operations. To learn more about the aggregation
130-
stages MongoDB supports in aggregation pipelines, see our tutorial on performing
131-
:manual:`updates with aggregation pipelines
128+
You can use aggregation pipelines to perform update operations. To learn more
129+
about the aggregation stages MongoDB supports in aggregation pipelines,
130+
see our tutorial on performing :manual:`updates with aggregation pipelines
132131
</tutorial/update-documents-with-aggregation-pipeline/>`.
133132

134133
Return Value
@@ -452,8 +451,7 @@ The following table describes the options available in ``UpdateOptions``:
452451
| Default: ``None``
453452

454453
* - ``hint``
455-
- | The index to use for the operation. This option is available
456-
only when connecting to {+server+} versions 4.2 and later.
454+
- | The index to use for the operation.
457455
|
458456
| Type: ``Hint``
459457
| Default: ``None``
@@ -469,16 +467,14 @@ The following table describes the options available in ``UpdateOptions``:
469467

470468
* - ``let_vars``
471469
- | A map of parameters and values. These parameters can be accessed
472-
as variables in aggregation expressions. This option is available
473-
only when connecting to {+server+} versions 5.0 and later.
470+
as variables in aggregation expressions.
474471
|
475472
| Type: ``Document``
476473

477474
* - ``comment``
478475
- | An arbitrary ``Bson`` value tied to the operation to trace
479476
it through the database profiler, ``currentOp``, and
480-
logs. This option is available only when connecting to
481-
{+server+} versions 4.4 and later.
477+
logs.
482478
|
483479
| Type: ``Bson``
484480
| Default: ``None``

source/fundamentals/crud/write-operations/delete.txt

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -113,24 +113,21 @@ The following table describes the options available in ``DeleteOptions``:
113113
* - ``hint``
114114
- | The index to use for the operation. To learn more about
115115
indexes, see :manual:`Indexes </indexes/>` in the Server
116-
manual. This option is available only when connecting to
117-
{+server+} versions 4.4 and later.
116+
manual.
118117
|
119118
| Type: ``Hint``
120119
| Default: ``None``
121120

122121
* - ``let_vars``
123122
- | A map of parameters and values. These parameters can be accessed
124-
as variables in aggregation expressions. This option is available
125-
only when connecting to {+server+} versions 5.0 and later.
123+
as variables in aggregation expressions.
126124
|
127125
| Type: ``Document``
128126

129127
* - ``comment``
130128
- | An arbitrary ``Bson`` value tied to the operation to trace
131129
it through the database profiler, ``currentOp``, and
132-
logs. This option is available only when connecting to
133-
{+server+} versions 4.4 and later.
130+
logs.
134131
|
135132
| Type: ``Bson``
136133
| Default: ``None``

source/fundamentals/crud/write-operations/insert.txt

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -150,8 +150,7 @@ The following table describes the options available in ``InsertOneOptions``:
150150
* - ``comment``
151151
- | An arbitrary ``Bson`` value tied to the operation to trace
152152
it through the database profiler, ``currentOp``, and
153-
logs. This option is available only when connecting to
154-
{+server+} versions 4.4 and later.
153+
logs.
155154
|
156155
| Type: ``Bson``
157156
| Default: ``None``
@@ -255,8 +254,7 @@ The following table describes the options available in ``InsertManyOptions``:
255254
* - ``comment``
256255
- | An arbitrary ``Bson`` value tied to the operation to trace
257256
it through the database profiler, ``currentOp``, and
258-
logs. This option is available only when connecting to
259-
{+server+} versions 4.4 and later.
257+
logs.
260258
|
261259
| Type: ``Bson``
262260
| Default: ``None``

source/fundamentals/indexes.txt

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -114,8 +114,7 @@ disk space and memory. Additionally, if a write operation updates an
114114
indexed field, MongoDB also must update the relevant index.
115115

116116
MongoDB supports dynamic schemas, so your application can query
117-
against fields with unknown or variable names. If you are connected to
118-
MongoDB Server version 4.2 or later, you can create wildcard indexes to
117+
against fields with unknown or variable names. You can create wildcard indexes to
119118
support these queries. To learn more about this index type, see
120119
:manual:`Wildcard Indexes </core/indexes/index-types/index-wildcard/>`
121120
in the Server manual.

source/includes/mongodb-compatibility-table-rust.rst

Lines changed: 1 addition & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -7,77 +7,37 @@
77
- MongoDB 8.0
88
- MongoDB 7.0
99
- MongoDB 6.0
10-
- MongoDB 5.0
11-
- MongoDB 4.4
12-
- MongoDB 4.2
13-
- MongoDB 4.0
14-
- MongoDB 3.6
1510
* - 3.1 to 3.2 [#2.5-onwards-limitation]_
1611
- ✓
1712
- ✓
1813
- ✓
19-
- ✓
20-
- ✓
21-
- ✓
22-
- ✓
23-
-
2414
* - 2.6 to 3.0 [#2.5-onwards-limitation]_
2515
- ⊛
2616
- ✓
2717
- ✓
28-
- ✓
29-
- ✓
30-
- ✓
31-
- ✓
32-
- ✓
3318
* - 2.5 [#2.5-onwards-limitation]_
3419
- ⊛
3520
- ⊛
3621
- ⊛
37-
- ✓
38-
- ✓
39-
- ✓
40-
- ✓
41-
- ✓
4222
* - 2.4 [#2.4-limitation]_
4323
- ⊛
4424
- ⊛
4525
- ⊛
46-
- ✓
47-
- ✓
48-
- ✓
49-
- ✓
50-
- ✓
5126
* - 2.2 to 2.3 [#2.2-2.3-limitation]_
5227
- ⊛
5328
- ⊛
5429
- ⊛
55-
- ✓
56-
- ✓
57-
- ✓
58-
- ✓
59-
- ✓
6030
* - 2.1 [#2.1-limitation]_
6131
- ⊛
6232
- ⊛
6333
- ⊛
64-
- ✓
65-
- ✓
66-
- ✓
67-
- ✓
68-
- ✓
6934
* - 2.0 [#2.0-limitation]_
7035
- ⊛
7136
- ⊛
7237
- ⊛
73-
- ✓
74-
- ✓
75-
- ✓
76-
- ✓
77-
- ✓
7838

7939
The {+driver-short+} is not compatible with {+server+} versions
80-
older than 3.6.
40+
older than 6.0.
8141

8242
.. [#2.5-onwards-limitation] These {+driver-short+} versions do not support
8343
:manual:`OCSP </core/security-transport-encryption/#ocsp--online-certificate-status-protocol->`.

0 commit comments

Comments
 (0)