Updating documentation for comparison operators

Author: binarycleric

README.md

@@ -225,6 +225,31 @@ puts optimized_times.less_than?(baseline_times, alpha: 0.01)  # More stringent t
 puts optimized_times.less_than?(baseline_times, alpha: 0.10)  # More lenient test
 ```
 
+#### Comparison Operators
+
+The gem provides convenient operator shortcuts for statistical comparisons:
+
+##### `#>(other, alpha: 0.05)` and `#<(other, alpha: 0.05)`
+
+Shorthand operators for `greater_than?` and `less_than?` respectively.
+
+```ruby
+# Performance comparison using operators
+baseline_times = [150, 165, 155, 170, 160, 145, 175]
+optimized_times = [120, 125, 115, 130, 118, 122, 128]
+
+# These are equivalent:
+puts baseline_times.greater_than?(optimized_times)  # => true
+puts baseline_times > optimized_times               # => true
+
+puts optimized_times.less_than?(baseline_times)    # => true
+puts optimized_times < baseline_times               # => true
+
+# With custom alpha levels (use explicit method syntax for parameters)
+puts baseline_times.>(optimized_times, alpha: 0.01)  # More stringent
+puts optimized_times.<(baseline_times, alpha: 0.10)  # More lenient
+```
+
 ### Comparison Methods
 
 #### `#percentage_difference(other)`
@@ -589,6 +614,8 @@ end
 | `degrees_of_freedom(other)` | Degrees of freedom for t-test | Float | Uses Welch's formula, accounts for unequal variances |
 | `greater_than?(other, alpha: 0.05)` | Test if mean is significantly greater | Boolean | One-tailed t-test, customizable alpha level |
 | `less_than?(other, alpha: 0.05)` | Test if mean is significantly less | Boolean | One-tailed t-test, customizable alpha level |
+| `>(other, alpha: 0.05)` | Alias for `greater_than?` | Boolean | Shorthand operator for statistical comparison |
+| `<(other, alpha: 0.05)` | Alias for `less_than?` | Boolean | Shorthand operator for statistical comparison |
 | `percentage_difference(other)` | Absolute percentage difference | Float | Always positive, symmetric comparison |
 | `signed_percentage_difference(other)` | Signed percentage difference | Float | Preserves direction, useful for A/B tests |
 | `remove_outliers(multiplier: 1.5)` | Remove outliers using IQR method | Array | Returns new array, original unchanged |

lib/enumerable_stats/enumerable_ext.rb

@@ -147,16 +147,6 @@ def greater_than?(other, alpha: 0.05)
       t_stat > critical_value
     end
 
-    # Alias for greater_than?
-    def >(other, alpha: 0.05)
-      greater_than?(other, alpha: alpha)
-    end
-
-    # Alias for less_than?
-    def <(other, alpha: 0.05)
-      less_than?(other, alpha: alpha)
-    end
-
     # Tests if this collection's mean is significantly less than another collection's mean
     # using a one-tailed Student's t-test. Returns true if the test indicates statistical
     # significance at the specified alpha level.
@@ -177,6 +167,32 @@ def less_than?(other, alpha: 0.05)
       t_stat < -critical_value
     end
 
+    # Operator alias for greater_than? - tests if this collection's mean is significantly greater
+    #
+    # @param other [Enumerable] Another collection to compare against
+    # @param alpha [Float] The significance level (default: 0.05 for 95% confidence)
+    # @return [Boolean] true if this collection's mean is significantly greater
+    # @example
+    #   baseline = [100, 110, 105, 115, 95]
+    #   optimized = [85, 95, 90, 100, 80]
+    #   baseline > optimized  # => true (baseline is significantly greater)
+    def >(other, alpha: 0.05)
+      greater_than?(other, alpha: alpha)
+    end
+
+    # Operator alias for less_than? - tests if this collection's mean is significantly less
+    #
+    # @param other [Enumerable] Another collection to compare against
+    # @param alpha [Float] The significance level (default: 0.05 for 95% confidence)
+    # @return [Boolean] true if this collection's mean is significantly less
+    # @example
+    #   optimized = [85, 95, 90, 100, 80]
+    #   baseline = [100, 110, 105, 115, 95]
+    #   optimized < baseline  # => true (optimized is significantly less)
+    def <(other, alpha: 0.05)
+      less_than?(other, alpha: alpha)
+    end
+
     # Calculates the arithmetic mean (average) of the collection
     #
     # @return [Float] The arithmetic mean of all numeric values