Internal PR feedback

Author: nvillahermosa-mdb

snooty.toml

@@ -333,7 +333,7 @@ targets = [
 
 variant = "warning"
 value = """
-    {+qe-equality-ga+} is generally available (GA) in \
+    The {+qe-equality-ga+} is generally available (GA) in \
     MongoDB 7.0 and later. Data encrypted using the {+qe-preview+} \ 
     from earlier versions is incompatible with the GA. \
     For more information, see :ref:`7.0-compatibility`.
@@ -345,7 +345,7 @@ targets = ["core/csfle.txt", "core/csfle/*.txt", "core/csfle/*/*.txt"]
 variant = "tip"
 value = """
     {+qe-equality-ga+} is now available. \
-    To learn more about {+qe+}, see :ref:`qe-manual-feature-qe`.
+    To learn more, see :ref:`qe-manual-feature-qe`.
     """
 
 [bundle]

source/core/queryable-encryption/fundamentals/manage-collections.txt

@@ -12,12 +12,14 @@ Encrypted Collection Management
    :depth: 2
    :class: singlecol
 
-Every encrypted field in a collection adds writes to insert,
-update, and delete operations. It also requires additional storage,
-since MongoDB maintains an index of encrypted fields. This section
-lists the writes per operation and explains how to compact encrypted
-collection indexes, so that you can plan accordingly to minimize write
-and storage costs.
+It is important that you understand the performance and storage costs of field level encryption. Each encrypted field:
+
+- Adds adds writes to insert, update, and delete operations.
+- Requires additional storage, because MongoDB maintains an encrypted field index.
+
+This section lists the writes per operation and explains how to compact
+encrypted collection indexes so that you can minimize write and storage
+costs.
 
 Overview
 --------
@@ -133,15 +135,15 @@ metadata collections.
 Index Compaction
 ----------------
 
-.. important::
-
-   You must manually run index compaction. MongoDB will automatically 
-   run index compaction in a future release.
-
 As you insert, update, and delete documents, the metadata collections
 change and grow. Index compaction prunes the metadata collections and 
 reduces their size.
 
+.. important::
+
+   You must manually run index compaction. Compaction only works on
+   clients configured for {+qe+}.
+
 Run index compaction when the size of ``ECOC`` exceeds 1 GB.
 
 You can check the size of your collections using :binary:`~bin.mongosh`
@@ -163,10 +165,6 @@ and issuing the :method:`db.collection.totalSize()` command.
 
         1407960328
 
-.. important::
-
-   You must configure your client for {+qe+} to run index compaction.
-
 To run index compaction, use :binary:`~bin.mongosh` and run the
 ``db.collection.compactStructuredEncryptionData()`` command to reduce
 the size of the metadata collections.

source/release-notes/7.0-compatibility.txt

@@ -53,10 +53,10 @@ can't query encrypted fields or insert data.
 
 If you encrypted data using the {+qe-preview+}:
 
-# Upgrade MongoDB server and drivers to 7.0
-# Query each encrypted collection from a 7.0 driver to decrypt it. 
-# Save the output locally. 
-# Configure a new encrypted collection and ingest the data.
+#. Upgrade MongoDB server and drivers to 7.0
+#. Query each encrypted collection from a 7.0 driver to decrypt it. 
+#. Save the output locally. 
+#. Configure a new encrypted collection and ingest the data.
 
 .. warning::
    * The :binary:`~bin.mongoexport` and :binary:`~bin.mongodump` 

source/release-notes/7.0.txt

@@ -187,6 +187,11 @@ remove data that uses any of the following features:
 - Config servers that have collections with
   ``changeStreamPreAndPostImages`` enabled
 
+.. toctree::
+   :titlesonly:
+   :hidden:
+
+   /release-notes/7.0-compatibility
 .. toctree::
    :titlesonly:
    :hidden: