MINOR: Added evolving annotation to DeleteShareGroupsResult. (apache#19133)

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

Co-authored-by: Andrew Schofield <[email protected]>

Reviewers: Chia-Ping Tsai <[email protected]>, Andrew Schofield <[email protected]>

Author: smjn

clients/src/main/java/org/apache/kafka/clients/admin/Admin.java

@@ -1846,6 +1846,7 @@ default ListShareGroupOffsetsResult listShareGroupOffsets(Map<String, ListShareG
     /**
      * 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 @@ default DeleteShareGroupsResult deleteShareGroups(Collection<String> groupIds) {
     /**
      * 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.
      */

clients/src/main/java/org/apache/kafka/clients/admin/DeleteShareGroupsResult.java

@@ -18,14 +18,18 @@
 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;
 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;