From 16b5765e2b23b43b7894f9600b5c2613c78377db Mon Sep 17 00:00:00 2001
From: Valentin Kovalenko <valentin.kovalenko@mongodb.com>
Date: Thu, 12 Mar 2026 11:22:13 -0600
Subject: [PATCH] Add `TODO-JAVA-6126` to inform readers that the problem is
 known

---
 .../mongodb/internal/session/BaseClientSessionImpl.java  | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/driver-core/src/main/com/mongodb/internal/session/BaseClientSessionImpl.java b/driver-core/src/main/com/mongodb/internal/session/BaseClientSessionImpl.java
index 48d5efc9f57..6d1c5619dd2 100644
--- a/driver-core/src/main/com/mongodb/internal/session/BaseClientSessionImpl.java
+++ b/driver-core/src/main/com/mongodb/internal/session/BaseClientSessionImpl.java
@@ -240,6 +240,13 @@ protected TimeoutSettings getTimeoutSettings(final TransactionOptions transactio
     }
 
     protected enum TransactionState {
-        NONE, IN, COMMITTED, ABORTED
+        NONE,
+        /**
+         * TODO-JAVA-6126 We miss the `STARTING` state, it is combined with the {@link #IN} state.
+         * See <a href="https://jira.mongodb.org/browse/JAVA-6126">JAVA-6126</a> for more details.
+         */
+        IN,
+        COMMITTED,
+        ABORTED
     }
 }