Add additional test-cases.

Author: vbabanin

source/mongodb-handshake/tests/README.md

@@ -110,48 +110,80 @@ Before each test case, perform the setup.
         | version  | 1.2              |
         | platform | Library Platform |
 
-2. Send a `ping` command to the server and verify:
-
-    - The command succeeds.
-    - The wrapping library metadata is appended to the respective `client.driver` fields of the `hello` command.
+2. Send a `ping` command to the server and verify that the command succeeds.
 
 3. Save intercepted `client` document as `initialClientMetadata`.
 
 4. Wait 5ms for the connection to become idle.
 
 #### Parameterized test cases
 
-**Case 1**
+| Case | Name      | Version | Platform           |
+| ---- | --------- | ------- | ------------------ |
+| 1    | framework | 2.0     | Framework Platform |
+| 2    | framework | 2.0     | null               |
+| 3    | framework | null    | Framework Platform |
+| 4    | framework | null    | null               |
+
+#### Running a test case
+
+1. Append the `DriverInfoOptions` from the selected test case to the `MongoClient` metadata.
+
+2. Send a `ping` command to the server and verify:
+
+    - The command succeeds.
+
+    - The framework metadata is appended to the existing `DriverInfoOptions` in the `client.driver` fields of the `hello`
+        command, with values separated by a pipe `|`.
+
+        - `client.driver.name`:
+            - If test case's name is non-null: `library|<name>`
+            - Otherwise, the field remains unchanged: `library`
+        - `client.driver.version`:
+            - If test case's version is non-null: `1.2|<version>`
+            - Otherwise, the field remains unchanged: `1.2`
+        - `client.driver.platform`:
+            - If test case's platform is non-null: `Library Platform|<platform>`
+            - Otherwise, the field remains unchanged: `Library Platform`
+
+    - All other subfields in the `client` document remain unchanged from `initialClientMetadata`.
 
-| Field    | Value              |
-| -------- | ------------------ |
-| name     | framework          |
-| version  | 2.0                |
-| platform | Framework Platform |
+## Test 2: Multiple Successive Metadata Updates
 
-**Case 2**
+Drivers should verify that after `MongoClient` initialization, metadata can be updated multiple times, not replaced, and
+is visible in the `hello` command of new connections.
 
-| Field    | Value     |
-| -------- | --------- |
-| name     | framework |
-| version  | 2.0       |
-| platform | null      |
+There are multiple test cases parameterized with `DriverInfoOptions` to be appended after a previous metadata update.
+Before each test case, perform the setup.
 
-**Case 3**
+### Setup
 
-| Field    | Value              |
-| -------- | ------------------ |
-| name     | framework          |
-| version  | null               |
-| platform | Framework Platform |
+1. Create a `MongoClient` instance with:
 
-**Case 4**
+    - `maxIdleTimeMS` set to `1ms`
 
-| Field    | Value     |
-| -------- | --------- |
-| name     | framework |
-| version  | null      |
-| platform | null      |
+2. Append the following `DriverInfoOptions` to the `MongoClient` metadata:
+
+    | Field    | Value            |
+    | -------- | ---------------- |
+    | name     | library          |
+    | version  | 1.2              |
+    | platform | Library Platform |
+
+3. Send a `ping` command to the server and verify that the command succeeds.
+
+4. Save intercepted `client` document as `updatedClientMetadata`.
+
+5. Wait 5ms for the connection to become idle.
+
+#### Parameterized test cases
+
+| Case | Name      | Version | Platform           |
+| ---- | --------- | ------- | ------------------ |
+| 1    | framework | 2.0     | Framework Platform |
+| 2    | framework | 2.0     | null               |
+| 3    | framework | null    | Framework Platform |
+| 4    | framework | null    | null               |
 
 #### Running a test case
 
@@ -174,9 +206,9 @@ Before each test case, perform the setup.
             - If test case's platform is non-null: `Library Platform|<platform>`
             - Otherwise, the field remains unchanged: `Library Platform`
 
-    - All other subfields in the `client` document remain unchanged from `initialClientMetadata`.
+    - All other subfields in the `client` document remain unchanged from `updatedClientMetadata`.
 
-### Test 2: Test that metadata is not updated on established connections
+### Test 3: Test that metadata is not updated on established connections
 
 Drivers should verify that appending metadata after `MongoClient` initialization does **not** close existing
 connections, and that no new `hello` command is sent.