Add tests, enhance docs in KadaneAlgorithm.java (#5646)

src/main/java/com/thealgorithms/dynamicprogramming/KadaneAlgorithm.java

@@ -1,36 +1,52 @@
 package com.thealgorithms.dynamicprogramming;
 
 /**
- * @author <a href="https://github.com/siddhant2002">Siddhant Swarup Mallick</a>
- * Program description - To find the maximum subarray sum
+ * This class implements Kadane's Algorithm to find the maximum subarray sum
+ * within a given array of integers. The algorithm efficiently computes the maximum
+ * sum of a contiguous subarray in linear time.
+ *
+ * Author: <a href="https://github.com/siddhant2002">Siddhant Swarup Mallick</a>
  */
 public final class KadaneAlgorithm {
     private KadaneAlgorithm() {
     }
 
     /**
-     * OUTPUT :
-     * Input - {89,56,98,123,26,75,12,40,39,68,91}
-     * Output: it returns either true or false
-     * 1st approach Time Complexity : O(n)
-     * Auxiliary Space Complexity : O(1)
+     * Computes the maximum subarray sum using Kadane's Algorithm and checks
+     * if it matches a predicted answer.
+     *
+     * @param a              The input array of integers for which the maximum
+     *                       subarray sum is to be calculated.
+     * @param predictedAnswer The expected maximum subarray sum to be verified
+     *                       against the computed sum.
+     * @return true if the computed maximum subarray sum equals the predicted
+     *         answer, false otherwise.
+     *
+     * <p>Example:</p>
+     * <pre>
+     * Input: {89, 56, 98, 123, 26, 75, 12, 40, 39, 68, 91}
+     * Output: true if the maximum subarray sum is equal to the
+     *         predicted answer.
+     * </pre>
+     *
+     * <p>Algorithmic Complexity:</p>
+     * <ul>
+     * <li>Time Complexity: O(n) - the algorithm iterates through the array once.</li>
+     * <li>Auxiliary Space Complexity: O(1) - only a constant amount of additional space is used.</li>
+     * </ul>
      */
     public static boolean maxSum(int[] a, int predictedAnswer) {
         int sum = a[0];
         int runningSum = 0;
+
         for (int k : a) {
-            runningSum = runningSum + k;
-            // running sum of all the indexs are stored
+            runningSum += k;
             sum = Math.max(sum, runningSum);
-            // the max is stored inorder to the get the maximum sum
             if (runningSum < 0) {
                 runningSum = 0;
             }
-            // if running sum is negative then it is initialized to zero
         }
-        // for-each loop is used to iterate over the array and find the maximum subarray sum
+
         return sum == predictedAnswer;
-        // It returns true if sum and predicted answer matches
-        // The predicted answer is the answer itself. So it always return true
     }
 }