Change To Average.java

Author: bayramtturgutt

src/main/java/com/thealgorithms/maths/Average.java

@@ -1,24 +1,27 @@
 package com.thealgorithms.maths;
 
 /**
- * Utility class for calculating the average of numeric arrays.
+ * A utility class for computing the average of numeric arrays.
+ * This class provides static methods to calculate the average of arrays
+ * of both {@code double} and {@code int} values.
  */
 public final class Average {
 
-    // Private constructor to prevent instantiation
+    // Prevent instantiation of this utility class
     private Average() {
+        throw new UnsupportedOperationException("This is a utility class and cannot be instantiated.");
     }
 
     /**
-     * Calculates the average of a double array.
+     * Computes the average of a {@code double} array.
      *
-     * @param numbers an array of doubles
-     * @return the mean of the given numbers
-     * @throws IllegalArgumentException if the array is null or empty
+     * @param numbers an array of {@code double} values
+     * @return the average of the given numbers
+     * @throws IllegalArgumentException if the input array is {@code null} or empty
      */
-    public static double calculateAverage(double[] numbers) {
+    public static double computeAverage(double[] numbers) {
         if (numbers == null || numbers.length == 0) {
-            throw new IllegalArgumentException("Array cannot be null or empty.");
+            throw new IllegalArgumentException("Array must not be null or empty.");
         }
         double sum = 0;
         for (double number : numbers) {
@@ -28,15 +31,15 @@ public static double calculateAverage(double[] numbers) {
     }
 
     /**
-     * Calculates the average of an int array.
+     * Computes the average of an {@code int} array.
      *
-     * @param numbers an array of integers
-     * @return the mean of the given numbers
-     * @throws IllegalArgumentException if the array is null or empty
+     * @param numbers an array of {@code int} values
+     * @return the average of the given numbers
+     * @throws IllegalArgumentException if the input array is {@code null} or empty
      */
-    public static int calculateAverage(int[] numbers) {
+    public static int computeAverage(int[] numbers) {
         if (numbers == null || numbers.length == 0) {
-            throw new IllegalArgumentException("Array cannot be null or empty.");
+            throw new IllegalArgumentException("Array must not be null or empty.");
         }
         long sum = 0;
         for (int number : numbers) {