From d66cc5c9b26d2c36bf1bba12729445dfe95d319d Mon Sep 17 00:00:00 2001
From: Ross Lawley <ross.lawley@gmail.com>
Date: Mon, 6 Oct 2025 16:32:59 +0100
Subject: [PATCH] Annotated all internal packages

JAVA-5975
---
 .../internal/async/function/package-info.java        |  6 ++++++
 .../com/mongodb/internal/async/package-info.java     |  3 +++
 .../internal/authentication/package-info.java        |  4 ++++
 .../com/mongodb/internal/binding/package-info.java   |  4 +++-
 .../main/com/mongodb/internal/bulk/package-info.java |  4 +++-
 .../main/com/mongodb/internal/capi/package-info.java |  5 ++++-
 .../internal/client/model/bulk/package-info.java     |  5 ++++-
 .../client/model/changestream/package-info.java      |  4 +++-
 .../mongodb/internal/client/model/package-info.java  |  4 +++-
 .../com/mongodb/internal/client/package-info.java    |  4 +++-
 .../mongodb/internal/client/vault/package-info.java  |  4 +++-
 .../internal/connection/netty/package-info.java      |  5 ++++-
 .../mongodb/internal/connection/package-info.java    |  5 +++--
 .../connection/tlschannel/async/package-info.java    |  6 ++++--
 .../internal/connection/tlschannel/package-info.java | 12 ++++--------
 .../internal/diagnostics/logging/package-info.java   |  5 +++--
 .../main/com/mongodb/internal/dns/package-info.java  |  5 +++--
 .../com/mongodb/internal/event/package-info.java     |  5 +++--
 .../com/mongodb/internal/function/package-info.java  |  4 +++-
 .../com/mongodb/internal/inject/package-info.java    |  5 +++--
 .../com/mongodb/internal/logging/package-info.java   |  5 +++--
 .../com/mongodb/internal/operation/package-info.java |  5 +++--
 .../internal/operation/retry/package-info.java       |  5 +++--
 .../src/main/com/mongodb/internal/package-info.java  |  3 +++
 .../com/mongodb/internal/selector/package-info.java  |  5 +++--
 .../com/mongodb/internal/session/package-info.java   |  5 +++--
 .../com/mongodb/internal/thread/package-info.java    |  5 +++--
 .../main/com/mongodb/internal/time/package-info.java |  4 +++-
 .../com/mongodb/internal/validator/package-info.java |  5 +++--
 .../client/internal/crypt/package-info.java          |  6 +++---
 .../client/internal/gridfs/package-info.java         |  6 +++---
 .../client/internal/package-info.java                |  7 ++++---
 .../client/internal/vault/package-info.java          |  6 +++---
 .../com/mongodb/client/internal/package-info.java    |  5 +++++
 34 files changed, 114 insertions(+), 57 deletions(-)

diff --git a/driver-core/src/main/com/mongodb/internal/async/function/package-info.java b/driver-core/src/main/com/mongodb/internal/async/function/package-info.java
index e85d91432a..2a89dc73a5 100644
--- a/driver-core/src/main/com/mongodb/internal/async/function/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/async/function/package-info.java
@@ -14,7 +14,13 @@
  * limitations under the License.
  */
 
+/**
+ * This package contains internal functionality that may change at any time.
+ */
+
+@Internal
 @NonNullApi
 package com.mongodb.internal.async.function;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/async/package-info.java b/driver-core/src/main/com/mongodb/internal/async/package-info.java
index 39b952eead..c6c6296725 100644
--- a/driver-core/src/main/com/mongodb/internal/async/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/async/package-info.java
@@ -15,9 +15,12 @@
  */
 
 /**
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.async;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/authentication/package-info.java b/driver-core/src/main/com/mongodb/internal/authentication/package-info.java
index bbeb09628a..5a0915e39a 100644
--- a/driver-core/src/main/com/mongodb/internal/authentication/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/authentication/package-info.java
@@ -15,9 +15,13 @@
  */
 
 /**
+ * This package contains internal functionality that may change at any time.
  */
 
+
+@Internal
 @NonNullApi
 package com.mongodb.internal.authentication;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/binding/package-info.java b/driver-core/src/main/com/mongodb/internal/binding/package-info.java
index 57d1f7430b..d514628e1b 100644
--- a/driver-core/src/main/com/mongodb/internal/binding/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/binding/package-info.java
@@ -15,10 +15,12 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.binding;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/bulk/package-info.java b/driver-core/src/main/com/mongodb/internal/bulk/package-info.java
index 936893bcfe..40daa3eec7 100644
--- a/driver-core/src/main/com/mongodb/internal/bulk/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/bulk/package-info.java
@@ -15,10 +15,12 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.bulk;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/capi/package-info.java b/driver-core/src/main/com/mongodb/internal/capi/package-info.java
index e0feb7fb9f..d903b56c42 100644
--- a/driver-core/src/main/com/mongodb/internal/capi/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/capi/package-info.java
@@ -15,10 +15,13 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
 
+
+@Internal
 @NonNullApi
 package com.mongodb.internal.capi;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/client/model/bulk/package-info.java b/driver-core/src/main/com/mongodb/internal/client/model/bulk/package-info.java
index 2d66f44646..c344a50368 100644
--- a/driver-core/src/main/com/mongodb/internal/client/model/bulk/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/client/model/bulk/package-info.java
@@ -15,9 +15,12 @@
  */
 
 /**
- * Internal program elements related to {@link com.mongodb.client.model.bulk}.
+ * This package contains internal functionality that may change at any time.
  */
+
+@Internal
 @NonNullApi
 package com.mongodb.internal.client.model.bulk;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/client/model/changestream/package-info.java b/driver-core/src/main/com/mongodb/internal/client/model/changestream/package-info.java
index edbdd14c85..35e0c4b517 100644
--- a/driver-core/src/main/com/mongodb/internal/client/model/changestream/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/client/model/changestream/package-info.java
@@ -15,10 +15,12 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.client.model.changestream;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/client/model/package-info.java b/driver-core/src/main/com/mongodb/internal/client/model/package-info.java
index 574e6d0bcc..f37e6c8451 100644
--- a/driver-core/src/main/com/mongodb/internal/client/model/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/client/model/package-info.java
@@ -15,10 +15,12 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.client.model;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/client/package-info.java b/driver-core/src/main/com/mongodb/internal/client/package-info.java
index 03c3a2bfd9..347b327f57 100644
--- a/driver-core/src/main/com/mongodb/internal/client/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/client/package-info.java
@@ -15,10 +15,12 @@
  */
 
 /**
- * This package contains classes for internal client functionality.
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.client;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/client/vault/package-info.java b/driver-core/src/main/com/mongodb/internal/client/vault/package-info.java
index 51c351d1e1..83322719b0 100644
--- a/driver-core/src/main/com/mongodb/internal/client/vault/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/client/vault/package-info.java
@@ -15,10 +15,12 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.client.vault;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/connection/netty/package-info.java b/driver-core/src/main/com/mongodb/internal/connection/netty/package-info.java
index f19b029d03..f8a6162353 100644
--- a/driver-core/src/main/com/mongodb/internal/connection/netty/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/connection/netty/package-info.java
@@ -15,9 +15,12 @@
  */
 
 /**
- * Contains <a href="https://netty.io/">Netty</a>-specific program elements.
+ * This package contains internal functionality that may change at any time.
  */
+
+@Internal
 @NonNullApi
 package com.mongodb.internal.connection.netty;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/connection/package-info.java b/driver-core/src/main/com/mongodb/internal/connection/package-info.java
index c3f2f35acd..f1b0349c96 100644
--- a/driver-core/src/main/com/mongodb/internal/connection/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/connection/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.connection;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/connection/tlschannel/async/package-info.java b/driver-core/src/main/com/mongodb/internal/connection/tlschannel/async/package-info.java
index 637580fb72..14335d5c0d 100644
--- a/driver-core/src/main/com/mongodb/internal/connection/tlschannel/async/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/connection/tlschannel/async/package-info.java
@@ -18,7 +18,9 @@
  */
 
 /**
- * This package enables the usage of TLS Channel as an {@link
- * java.nio.channels.AsynchronousByteChannel}.
+ * This package contains internal functionality that may change at any time.
  */
+@Internal
 package com.mongodb.internal.connection.tlschannel.async;
+
+import com.mongodb.annotations.Internal;
diff --git a/driver-core/src/main/com/mongodb/internal/connection/tlschannel/package-info.java b/driver-core/src/main/com/mongodb/internal/connection/tlschannel/package-info.java
index 230fb17d6f..e633246649 100644
--- a/driver-core/src/main/com/mongodb/internal/connection/tlschannel/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/connection/tlschannel/package-info.java
@@ -18,13 +18,9 @@
  */
 
 /**
- * TLS Channel is a library that implements a ByteChannel interface to a TLS (Transport Layer
- * Security) connection. The library delegates all cryptographic operations to the standard Java TLS
- * implementation: SSLEngine; effectively hiding it behind an easy-to-use streaming API, that allows
- * to securitize JVM applications with minimal added complexity.
- *
- * <p>In other words, a simple library that allows the programmer to have TLS using the same
- * standard socket API used for plaintext, just like OpenSSL does for C, only for Java, filling a
- * specially painful missing feature of the standard Java library.
+ * This package contains internal functionality that may change at any time.
  */
+@Internal
 package com.mongodb.internal.connection.tlschannel;
+
+import com.mongodb.annotations.Internal;
diff --git a/driver-core/src/main/com/mongodb/internal/diagnostics/logging/package-info.java b/driver-core/src/main/com/mongodb/internal/diagnostics/logging/package-info.java
index 2a1b56a59e..44488d7eca 100644
--- a/driver-core/src/main/com/mongodb/internal/diagnostics/logging/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/diagnostics/logging/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.diagnostics.logging;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/dns/package-info.java b/driver-core/src/main/com/mongodb/internal/dns/package-info.java
index 6c516f9237..e02c7f1ebe 100644
--- a/driver-core/src/main/com/mongodb/internal/dns/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/dns/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.dns;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/event/package-info.java b/driver-core/src/main/com/mongodb/internal/event/package-info.java
index a595943297..f36c52a829 100644
--- a/driver-core/src/main/com/mongodb/internal/event/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/event/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.event;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/function/package-info.java b/driver-core/src/main/com/mongodb/internal/function/package-info.java
index baea9b145e..50db2793b8 100644
--- a/driver-core/src/main/com/mongodb/internal/function/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/function/package-info.java
@@ -15,9 +15,11 @@
  */
 
 /**
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.function;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/inject/package-info.java b/driver-core/src/main/com/mongodb/internal/inject/package-info.java
index 6e7581a8c4..34ad231d10 100644
--- a/driver-core/src/main/com/mongodb/internal/inject/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/inject/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.inject;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/logging/package-info.java b/driver-core/src/main/com/mongodb/internal/logging/package-info.java
index f244a5b352..74810176f8 100644
--- a/driver-core/src/main/com/mongodb/internal/logging/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/logging/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.logging;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/operation/package-info.java b/driver-core/src/main/com/mongodb/internal/operation/package-info.java
index ac3047a229..ffd207916d 100644
--- a/driver-core/src/main/com/mongodb/internal/operation/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/operation/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * The core of the MongoDB driver works via operations, using the command pattern. The main Operations supported by MongoDB are in this
- * package, as are helpers and infrastructure required for operation functionality.
+ * This package contains internal functionality that may change at any time.
  */
+@Internal
 @NonNullApi
 package com.mongodb.internal.operation;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/operation/retry/package-info.java b/driver-core/src/main/com/mongodb/internal/operation/retry/package-info.java
index 7e398f7de9..29c27a4791 100644
--- a/driver-core/src/main/com/mongodb/internal/operation/retry/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/operation/retry/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.operation.retry;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/package-info.java b/driver-core/src/main/com/mongodb/internal/package-info.java
index e7825fe129..52023d78b7 100644
--- a/driver-core/src/main/com/mongodb/internal/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/package-info.java
@@ -15,9 +15,12 @@
  */
 
 /**
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/selector/package-info.java b/driver-core/src/main/com/mongodb/internal/selector/package-info.java
index 6514d4daf1..ab05e07c08 100644
--- a/driver-core/src/main/com/mongodb/internal/selector/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/selector/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.selector;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/session/package-info.java b/driver-core/src/main/com/mongodb/internal/session/package-info.java
index a681216a67..faeb3aeaac 100644
--- a/driver-core/src/main/com/mongodb/internal/session/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/session/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.session;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/thread/package-info.java b/driver-core/src/main/com/mongodb/internal/thread/package-info.java
index e005dc6513..e5a0a9f723 100644
--- a/driver-core/src/main/com/mongodb/internal/thread/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/thread/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.thread;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/time/package-info.java b/driver-core/src/main/com/mongodb/internal/time/package-info.java
index 3b3ee45751..deb8463496 100644
--- a/driver-core/src/main/com/mongodb/internal/time/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/time/package-info.java
@@ -15,9 +15,11 @@
  */
 
 /**
- * This package contains program elements for working with time.
+ * This package contains internal functionality that may change at any time.
  */
+@Internal
 @NonNullApi
 package com.mongodb.internal.time;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/validator/package-info.java b/driver-core/src/main/com/mongodb/internal/validator/package-info.java
index cba0de4849..cec46638fb 100644
--- a/driver-core/src/main/com/mongodb/internal/validator/package-info.java
+++ b/driver-core/src/main/com/mongodb/internal/validator/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.validator;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/crypt/package-info.java b/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/crypt/package-info.java
index 759ba58699..3311b31a9d 100644
--- a/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/crypt/package-info.java
+++ b/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/crypt/package-info.java
@@ -15,11 +15,11 @@
  */
 
 /**
- * Utility classes for internal library use only.
- *
- * <p>This should not be considered a part of the public API.</p>
+ * This package contains internal functionality that may change at any time.
  */
+@Internal
 @NonNullApi
 package com.mongodb.reactivestreams.client.internal.crypt;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/gridfs/package-info.java b/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/gridfs/package-info.java
index ce1f07cc2b..d2582b398d 100644
--- a/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/gridfs/package-info.java
+++ b/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/gridfs/package-info.java
@@ -15,11 +15,11 @@
  */
 
 /**
- * Utility classes for internal library use only.
- *
- * <p>This should not be considered a part of the public API.</p>
+ * This package contains internal functionality that may change at any time.
  */
+@Internal
 @NonNullApi
 package com.mongodb.reactivestreams.client.internal.gridfs;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/package-info.java b/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/package-info.java
index 3b650b4a71..b683433d23 100644
--- a/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/package-info.java
+++ b/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/package-info.java
@@ -15,11 +15,12 @@
  */
 
 /**
- * Utility classes for internal library use only.
- *
- * <p>This should not be considered a part of the public API.</p>
+ * This package contains internal functionality that may change at any time.
  */
+
+@Internal
 @NonNullApi
 package com.mongodb.reactivestreams.client.internal;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/vault/package-info.java b/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/vault/package-info.java
index 59b16b7cc4..c4f3d32544 100644
--- a/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/vault/package-info.java
+++ b/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/vault/package-info.java
@@ -15,11 +15,11 @@
  */
 
 /**
- * Utility classes for internal library use only.
- *
- * <p>This should not be considered a part of the public API.</p>
+ * This package contains internal functionality that may change at any time.
  */
+@Internal
 @NonNullApi
 package com.mongodb.reactivestreams.client.internal.vault;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-sync/src/main/com/mongodb/client/internal/package-info.java b/driver-sync/src/main/com/mongodb/client/internal/package-info.java
index 4ad4a9813d..4d3affbab2 100644
--- a/driver-sync/src/main/com/mongodb/client/internal/package-info.java
+++ b/driver-sync/src/main/com/mongodb/client/internal/package-info.java
@@ -14,7 +14,12 @@
  * limitations under the License.
  */
 
+/**
+ * This package contains internal functionality that may change at any time.
+ */
+@Internal
 @NonNullApi
 package com.mongodb.client.internal;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;