Skip to content

Commit e652885

Browse files
committed
DOCSP-50027: reduce EOL server mentions (#190)
(cherry picked from commit 78d743f)
1 parent 043c0bc commit e652885

File tree

8 files changed

+49
-118
lines changed

8 files changed

+49
-118
lines changed

source/fundamentals/authentication.txt

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

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

66-
- :ref:`SCRAM-SHA-256 <rust-auth-scramsha256>`: an authentication mechanism that
66+
- :ref:`SCRAM-SHA-256 <rust-auth-scramsha256>`: An authentication mechanism that
6767
uses your database username and password, encrypted with the ``SHA-256``
68-
algorithm
69-
- :ref:`SCRAM-SHA-1 <rust-auth-scramsha1>`: an authentication mechanism that
68+
algorithm. This is the default authentication mechanism.
69+
- :ref:`SCRAM-SHA-1 <rust-auth-scramsha1>`: An authentication mechanism that
7070
uses your database username and password, encrypted with the ``SHA-1``
71-
algorithm
71+
algorithm.
7272

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

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

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

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

97-
.. _rust-auth-scramsha256:
85+
- ``db_username``: Your database username
86+
- ``db_password``: Your database password
87+
- ``db``: The authentication database associated with the user
9888

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

102-
To specify the ``SCRAM-SHA-256`` authentication mechanism, set the
95+
To explicitly specify the ``SCRAM-SHA-256`` authentication mechanism, set the
10396
``mechanism`` field of your ``Credential`` struct to
10497
``AuthMechanism::ScramSha256``. This example specifies the
10598
authentication mechanism by using the following placeholders:
@@ -159,11 +152,8 @@ feature flag to your ``mongodb`` dependency in your project's
159152
.. important::
160153

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

168158
The driver obtains the credentials only from the first source in which
169159
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
@@ -22,9 +22,9 @@ the total amount of data passed over the network.
2222

2323
The driver supports the following compressors:
2424

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

2929
.. note:: Compressor Selection
3030

source/fundamentals/crud/compound-operations.txt

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

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

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

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

334329
* - ``comment``
335330
- | An arbitrary ``Bson`` value tied to the operation to trace
336331
it through the database profiler, ``currentOp``, and
337-
logs. This option is available only when connecting to
338-
{+server+} versions 4.4 and later.
332+
logs.
339333
|
340334
| Type: ``Bson``
341335
| Default: ``None``
@@ -481,24 +475,21 @@ The following table describes the options available in
481475
* - ``hint``
482476
- | The index to use for the operation. To learn more about
483477
indexes, see :manual:`Indexes </indexes/>` in the Server
484-
manual. This option is available only when connecting to
485-
{+server+} versions 4.4 and later.
478+
manual.
486479
|
487480
| Type: ``Hint``
488481
| Default: ``None``
489482

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

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

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

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

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

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

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

453452
* - ``hint``
454-
- | The index to use for the operation. This option is available
455-
only when connecting to {+server+} versions 4.2 and later.
453+
- | The index to use for the operation.
456454
|
457455
| Type: ``Hint``
458456
| Default: ``None``
@@ -468,16 +466,14 @@ The following table describes the options available in ``UpdateOptions``:
468466

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

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

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

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

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

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

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

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

source/fundamentals/indexes.txt

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

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

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

Lines changed: 2 additions & 42 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
15-
* - 3.1 [#2.5-onwards-limitation]_
10+
* - 3.1
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)