diff --git a/source/connect/connection-options.txt b/source/connect/connection-options.txt
index 7d9fe378..0a9e5234 100644
--- a/source/connect/connection-options.txt
+++ b/source/connect/connection-options.txt
@@ -165,8 +165,8 @@ in the {+mdb-server+} manual.
      - Description
 
    * - ``connectTimeoutMS``
-     - | The time that {+driver-short+} waits when connecting a new
-         socket before timing out.
+     - | The time that {+driver-short+} waits when establishing a new
+         connection before timing out.
        |
        | **Data Type**: ``int``
        | **Default**: ``20000``
@@ -184,7 +184,9 @@ in the {+mdb-server+} manual.
        | **Connection URI Example**: ``maxConnecting=3``
 
    * - ``maxIdleTimeMS``
-     - | The maximum time that a connection can remain idle in the pool.
+     - | The maximum time that a connection can remain idle in the pool. When a connection
+         exceeds this limit, {+driver-short+} closes the connection and removes it from
+         the pool.
        |
        | **Data Type**: ``int``
        | **Default**: ``None`` (no limit)