From b89c819f638f07429e770c8699463e718d3ae69f Mon Sep 17 00:00:00 2001
From: Sushant Mahajan <smahajan@confluent.io>
Date: Thu, 6 Mar 2025 21:47:37 +0530
Subject: [PATCH] MINOR: Added evolving annotation to DeleteShareGroupsResult.
 (#19133)

* Added `InterfaceStability.Evolving` annotation to`DeleteShareGroupsResult`.
* Fixed some java doc.

Co-authored-by: Andrew Schofield <aschofield@confluent.io>

Reviewers: Chia-Ping Tsai <chia7712@gmail.com>, Andrew Schofield <aschofield@confluent.io>
---
 .../src/main/java/org/apache/kafka/clients/admin/Admin.java   | 2 ++
 .../apache/kafka/clients/admin/DeleteShareGroupsResult.java   | 4 ++++
 2 files changed, 6 insertions(+)

diff --git a/clients/src/main/java/org/apache/kafka/clients/admin/Admin.java b/clients/src/main/java/org/apache/kafka/clients/admin/Admin.java
index a0bb85899f8..67dd806e455 100644
--- a/clients/src/main/java/org/apache/kafka/clients/admin/Admin.java
+++ b/clients/src/main/java/org/apache/kafka/clients/admin/Admin.java
@@ -1846,6 +1846,7 @@ public interface Admin extends AutoCloseable {
     /**
      * Delete share groups from the cluster with the default options.
      *
+     * @param groupIds Collection of share group ids which are to be deleted.
      * @return The DeleteShareGroupsResult.
      */
     default DeleteShareGroupsResult deleteShareGroups(Collection<String> groupIds) {
@@ -1855,6 +1856,7 @@ public interface Admin extends AutoCloseable {
     /**
      * Delete share groups from the cluster.
      *
+     * @param groupIds Collection of share group ids which are to be deleted.
      * @param options The options to use when deleting a share group.
      * @return The DeleteShareGroupsResult.
      */
diff --git a/clients/src/main/java/org/apache/kafka/clients/admin/DeleteShareGroupsResult.java b/clients/src/main/java/org/apache/kafka/clients/admin/DeleteShareGroupsResult.java
index d91126eb505..c2791e681f7 100644
--- a/clients/src/main/java/org/apache/kafka/clients/admin/DeleteShareGroupsResult.java
+++ b/clients/src/main/java/org/apache/kafka/clients/admin/DeleteShareGroupsResult.java
@@ -18,6 +18,7 @@
 package org.apache.kafka.clients.admin;
 
 import org.apache.kafka.common.KafkaFuture;
+import org.apache.kafka.common.annotation.InterfaceStability;
 
 import java.util.Collection;
 import java.util.HashMap;
@@ -25,7 +26,10 @@ import java.util.Map;
 
 /**
  * The result of the {@link Admin#deleteShareGroups(Collection <String>, DeleteShareGroupsOptions)} call.
+ * <p></p>
+ * The API of this class is evolving, see {@link Admin} for details.
  */
+@InterfaceStability.Evolving
 public class DeleteShareGroupsResult {
     private final Map<String, KafkaFuture<Void>> futures;