Mark CSOT feature as Alpha

README.md

@@ -54,13 +54,13 @@ with prior patch releases of the same minor release branch.
 
 #### @Alpha
 
-APIs marked with the `@Alpha` annotation at the class, method or field level are in the early stages of development, 
-subject to incompatible changes, or even removal, in a future release and may lack some intended features. These APIs 
-may be unstable, have potential performance implications as development progresses, and are exempt from any compatibility 
-guarantees made by its containing library. 
+APIs marked with the `@Alpha` annotation at a public API element are in the early stages of development, subject to
+incompatible changes, or even removal, in a future release and may lack some intended features. An APIs bearing `@Alpha` 
+annotation may contain known issues affecting functionality, performance, and stability. They are also exempt from any 
+compatibility guarantees made by its containing library.
 
-It is inadvisable for <i>applications</i> to use Alpha APIs in production environments or for <i>libraries</i> 
-(which get included on users' CLASSPATHs, outside the library developers' control) to depend on these APIs. Alpha APIs 
+It is inadvisable for <i>applications</i> to use Alpha APIs in production environments or for <i>libraries</i>
+(which get included on users' CLASSPATHs, outside the library developers' control) to depend on these APIs. Alpha APIs
 are intended for <b>experimental purposes</b> only.
 
 #### @Beta

driver-core/src/main/com/mongodb/annotations/Reason.java

@@ -19,6 +19,7 @@
 /**
  * Enumerates the reasons an API element might be marked with annotations like {@link Alpha} or {@link Beta}.
  */
+@Beta(Reason.CLIENT)
 public enum Reason {
     /**
      * Indicates that the status of the driver API is the reason for the annotation.

driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/FindPublisher.java

@@ -18,6 +18,8 @@
 
 import com.mongodb.CursorType;
 import com.mongodb.ExplainVerbosity;
+import com.mongodb.annotations.Alpha;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.client.model.Collation;
 import com.mongodb.client.model.Projections;
@@ -288,6 +290,7 @@ public interface FindPublisher<TResult> extends Publisher<TResult> {
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     FindPublisher<TResult> timeoutMode(TimeoutMode timeoutMode);
 
     /**

driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/ListCollectionsPublisher.java

@@ -16,6 +16,8 @@
 
 package com.mongodb.reactivestreams.client;
 
+import com.mongodb.annotations.Alpha;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.lang.Nullable;
 import org.bson.BsonValue;
@@ -96,6 +98,7 @@ public interface ListCollectionsPublisher<TResult> extends Publisher<TResult> {
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     ListCollectionsPublisher<TResult> timeoutMode(TimeoutMode timeoutMode);
 
     /**

driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/ListDatabasesPublisher.java

@@ -17,6 +17,8 @@
 
 package com.mongodb.reactivestreams.client;
 
+import com.mongodb.annotations.Alpha;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.lang.Nullable;
 import org.bson.BsonValue;
@@ -119,6 +121,7 @@ public interface ListDatabasesPublisher<TResult> extends Publisher<TResult> {
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     ListDatabasesPublisher<TResult> timeoutMode(TimeoutMode timeoutMode);
 
     /**

driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/ListIndexesPublisher.java

@@ -16,6 +16,8 @@
 
 package com.mongodb.reactivestreams.client;
 
+import com.mongodb.annotations.Alpha;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.lang.Nullable;
 import org.bson.BsonValue;
@@ -85,6 +87,7 @@ public interface ListIndexesPublisher<TResult> extends Publisher<TResult> {
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     ListIndexesPublisher<TResult> timeoutMode(TimeoutMode timeoutMode);
 
     /**

driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/ListSearchIndexesPublisher.java

@@ -17,7 +17,9 @@
 package com.mongodb.reactivestreams.client;
 
 import com.mongodb.ExplainVerbosity;
+import com.mongodb.annotations.Alpha;
 import com.mongodb.annotations.Evolving;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.client.model.Collation;
 import com.mongodb.lang.Nullable;
@@ -110,6 +112,7 @@ public interface ListSearchIndexesPublisher<TResult> extends Publisher<TResult>
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     ListSearchIndexesPublisher<TResult> timeoutMode(TimeoutMode timeoutMode);
 
     /**

driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/MapReducePublisher.java

@@ -17,6 +17,8 @@
 package com.mongodb.reactivestreams.client;
 
 
+import com.mongodb.annotations.Alpha;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.client.model.Collation;
 import com.mongodb.lang.Nullable;
@@ -200,6 +202,7 @@ public interface MapReducePublisher<TResult> extends Publisher<TResult> {
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     MapReducePublisher<TResult> timeoutMode(TimeoutMode timeoutMode);
 
     /**

driver-sync/src/main/com/mongodb/client/AggregateIterable.java

@@ -17,6 +17,8 @@
 package com.mongodb.client;
 
 import com.mongodb.ExplainVerbosity;
+import com.mongodb.annotations.Alpha;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.client.model.Collation;
 import com.mongodb.lang.Nullable;
@@ -85,6 +87,7 @@ public interface AggregateIterable<TResult> extends MongoIterable<TResult> {
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     AggregateIterable<TResult> timeoutMode(TimeoutMode timeoutMode);
 
     /**

driver-sync/src/main/com/mongodb/client/DistinctIterable.java

@@ -16,6 +16,8 @@
 
 package com.mongodb.client;
 
+import com.mongodb.annotations.Alpha;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.client.model.Collation;
 import com.mongodb.lang.Nullable;
@@ -102,5 +104,6 @@ public interface DistinctIterable<TResult> extends MongoIterable<TResult> {
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     DistinctIterable<TResult> timeoutMode(TimeoutMode timeoutMode);
 }

driver-sync/src/main/com/mongodb/client/FindIterable.java

@@ -18,6 +18,8 @@
 
 import com.mongodb.CursorType;
 import com.mongodb.ExplainVerbosity;
+import com.mongodb.annotations.Alpha;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.client.model.Collation;
 import com.mongodb.client.model.Projections;
@@ -281,6 +283,7 @@ public interface FindIterable<TResult> extends MongoIterable<TResult> {
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     FindIterable<TResult> timeoutMode(TimeoutMode timeoutMode);
 
     /**

driver-sync/src/main/com/mongodb/client/ListCollectionsIterable.java

@@ -16,6 +16,8 @@
 
 package com.mongodb.client;
 
+import com.mongodb.annotations.Alpha;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.lang.Nullable;
 import org.bson.BsonValue;
@@ -92,5 +94,6 @@ public interface ListCollectionsIterable<TResult> extends MongoIterable<TResult>
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     ListCollectionsIterable<TResult> timeoutMode(TimeoutMode timeoutMode);
 }

driver-sync/src/main/com/mongodb/client/ListDatabasesIterable.java

@@ -16,6 +16,8 @@
 
 package com.mongodb.client;
 
+import com.mongodb.annotations.Alpha;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.lang.Nullable;
 import org.bson.BsonValue;
@@ -114,5 +116,6 @@ public interface ListDatabasesIterable<TResult> extends MongoIterable<TResult> {
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     ListDatabasesIterable<TResult> timeoutMode(TimeoutMode timeoutMode);
 }

driver-sync/src/main/com/mongodb/client/ListIndexesIterable.java

@@ -16,6 +16,8 @@
 
 package com.mongodb.client;
 
+import com.mongodb.annotations.Alpha;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.lang.Nullable;
 import org.bson.BsonValue;
@@ -81,5 +83,6 @@ public interface ListIndexesIterable<TResult> extends MongoIterable<TResult> {
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     ListIndexesIterable<TResult> timeoutMode(TimeoutMode timeoutMode);
 }

driver-sync/src/main/com/mongodb/client/ListSearchIndexesIterable.java

@@ -17,7 +17,9 @@
 package com.mongodb.client;
 
 import com.mongodb.ExplainVerbosity;
+import com.mongodb.annotations.Alpha;
 import com.mongodb.annotations.Evolving;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.client.model.Collation;
 import com.mongodb.lang.Nullable;
@@ -110,6 +112,7 @@ public interface ListSearchIndexesIterable<TResult> extends MongoIterable<TResul
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     ListSearchIndexesIterable<TResult> timeoutMode(TimeoutMode timeoutMode);
 
     /**

driver-sync/src/main/com/mongodb/client/MapReduceIterable.java

@@ -16,6 +16,8 @@
 
 package com.mongodb.client;
 
+import com.mongodb.annotations.Alpha;
+import com.mongodb.annotations.Reason;
 import com.mongodb.client.cursor.TimeoutMode;
 import com.mongodb.client.model.Collation;
 import com.mongodb.lang.Nullable;
@@ -192,5 +194,6 @@ public interface MapReduceIterable<TResult> extends MongoIterable<TResult> {
      * @return this
      * @since CSOT
      */
+    @Alpha(Reason.CLIENT)
     MapReduceIterable<TResult> timeoutMode(TimeoutMode timeoutMode);
 }