Fixed javadocs

Signed-off-by: Sriram Ganesh <[email protected]>

Author: rgsriram

server/src/main/java/org/opensearch/index/analysis/SegmentTopologyAnalyzer.java

@@ -232,6 +232,12 @@ public int getTotalDocs() {
     }
 
     // Inner classes
+    /**
+     * Represents a single segment within an index, containing metadata about its size,
+     * document count, and other characteristics.
+     *
+     * @opensearch.api
+     */
     @PublicApi(since = "3.0.0")
     public static class Segment implements Writeable {
         public final String name;
@@ -266,6 +272,12 @@ public void writeTo(StreamOutput out) throws IOException {
         }
     }
 
+    /**
+     * Contains calculated metrics about the segment topology of an index,
+     * including statistical measures like variance, skew, and distribution characteristics.
+     *
+     * @opensearch.api
+     */
     @PublicApi(since = "3.0.0")
     public static class SegmentMetrics {
         public final int segmentCount;
@@ -311,6 +323,12 @@ public SegmentMetrics(
         }
     }
 
+    /**
+     * Contains recommendations for optimal merge policy settings based on segment topology analysis,
+     * including flags for identified issues and suggested parameter values.
+     *
+     * @opensearch.api
+     */
     @PublicApi(since = "3.0.0")
     public static class MergePolicyRecommendations {
         public final boolean hasVarianceIssue;

server/src/main/java/org/opensearch/rest/action/admin/package-info.java

@@ -0,0 +1,37 @@
+/*
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * The OpenSearch Contributors require contributions made to
+ * this file be licensed under the Apache-2.0 license or a
+ * compatible open source license.
+ */
+
+/*
+ * Licensed to Elasticsearch under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * {@link org.opensearch.rest.RestHandler}s for administrative actions that can be taken on the cluster,
+ * indices, and other OpenSearch components like segment topology analysis and cluster management.
+ */
+/*
+ * Modifications Copyright OpenSearch Contributors. See
+ * GitHub history for details.
+ */
+
+package org.opensearch.rest.action.admin;