wording suggestions

Author: mdb-ad

source/client-side-encryption/client-side-encryption.md

@@ -1348,6 +1348,9 @@ server to insert or query. Drivers MUST document the following behavior:
 > To insert or query with an "Indexed", "Range", or "TextPreview" encrypted payload, use a `MongoClient` configured with
 > `AutoEncryptionOpts`. `AutoEncryptionOpts.bypassQueryAnalysis` may be true. `AutoEncryptionOpts.bypassAutoEncryption`
 > must be false.
+> The "TextPreview" algorithm is in preview and should be used for experimental workloads only. These features are
+> unstable and their security is not guaranteed until released as Generally Available (GA). The GA version of these
+> features may not be backwards compatible with the preview version.
 
 #### contentionFactor
 
@@ -1365,7 +1368,7 @@ One of the strings:
 - "substringPreview"
 
 queryType only applies when algorithm is "Indexed", "Range", or "TextPreview". libmongocrypt returns an error if
-queryType is set for a non-applicable queryType.
+queryType is set for a non-applicable algorithm.
 
 #### rangeOpts
 
@@ -2517,8 +2520,6 @@ explicit session parameter as described in the [Drivers Sessions Specification](
 
 ## Changelog
 
-- 2025-08-06: Add `TextPreview` prose tests.
-
 - 2025-08-06: Add `TextPreview` algorithm.
 
 - 2024-02-19: Add custom options AWS credential provider.

source/client-side-encryption/tests/README.md

@@ -3783,7 +3783,7 @@ as `key1Document`.
 Read the `"_id"` field of `key1Document` as `key1ID`.
 
 Drop and create the collection `db.explicit_encryption` using `encryptedFields` as an option. See
-[FLE 2 CreateCollection() and Collection.Drop()](../client-side-encryption.md#create-collection-helper).
+[QE CreateCollection() and Collection.Drop()](../client-side-encryption.md#create-collection-helper).
 
 Drop and create the collection `keyvault.datakeys`.
 
@@ -3811,6 +3811,30 @@ class AutoEncryptionOpts {
 }
 ```
 
+Use `clientEncryption` to encrypt the string `"foobarbaz"`.
+
+Encrypt using the following `EncryptOpts`:
+
+```typescript
+class EncryptOpts {
+   keyId : <key1ID>,
+   algorithm: "TextPreview",
+   contentionFactor: 0,
+   textOpts: TextOpts {
+      caseSensitive: true,
+      diacriticSensitive: true,
+      prefix: <PrefixOpts>,
+      suffix: <SuffixOpts>
+   },
+}
+```
+
+Use `encryptedClient` to insert the following document into `db.explicit_encryption`:
+
+```javascript
+{ "_id": 0, "encryptedText": <encrypted "foobarbaz"> }
+```
+
 The remaining tasks require setting `TextOpts`. [Test Setup: TextOpts](#test-setup-textopts) lists the values to use for
 `TextOpts` for each of the supported data types.
 
@@ -3823,6 +3847,7 @@ This section lists the values to use for `TextOpts` for each query type. Include
 class EncryptOpts {
    keyId : <key1ID>,
    algorithm: "TextPreview",
+   queryType: "<prefix/suffix/substring>Preview",
    contentionFactor: 0,
    textOpts: TextOpts {
       caseSensitive: true,
@@ -3860,30 +3885,6 @@ class EncryptOpts {
     }
     ```
 
-Use `clientEncryption` to encrypt the string `"foobarbaz"`.
-
-Encrypt using the following `EncryptOpts`:
-
-```typescript
-class EncryptOpts {
-   keyId : <key1ID>,
-   algorithm: "TextPreview",
-   contentionFactor: 0,
-   textOpts: TextOpts {
-      caseSensitive: true,
-      diacriticSensitive: true,
-      prefix: <PrefixOpts>,
-      suffix: <SuffixOpts>
-   },
-}
-```
-
-Use `encryptedClient` to insert the following document into `db.explicit_encryption`:
-
-```javascript
-{ "_id": 0, "encryptedText": <encrypted "foobarbaz"> }
-```
-
 #### Case 1: can find a document by prefix
 
 Use `clientEncryption.encrypt()` to encrypt the string `"foo"`: