From ca639ea6f6694ea13537565c9eb2a265a3641d1593a7455d27e1a61c1941acaa Mon Sep 17 00:00:00 2001
From: Minimons <minimons@r35157.crypto>
Date: Wed, 3 Dec 2025 10:37:58 +0100
Subject: [PATCH] NoIssue: Better documentation

---
 .../r35157/libs/random/RandomValueGeneratorString.java   | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/main/java/com/r35157/libs/random/RandomValueGeneratorString.java b/src/main/java/com/r35157/libs/random/RandomValueGeneratorString.java
index 5d5438e..d83c9c0 100644
--- a/src/main/java/com/r35157/libs/random/RandomValueGeneratorString.java
+++ b/src/main/java/com/r35157/libs/random/RandomValueGeneratorString.java
@@ -3,5 +3,12 @@ package com.r35157.libs.random;
 import org.jetbrains.annotations.NotNull;
 
 public interface RandomValueGeneratorString {
-    @NotNull String getSomeStringAlphaNumericOnly(int length);
+    /**
+     * Generate a random Alpha Numeric String of exactly the length given as the parameter.
+     *
+     * @param length Length of generated String - cannot be negative
+     * @return A non-null random String of the length given
+     * @throws IllegalArgumentException If length is negative
+     */
+    @NotNull String getSomeStringAlphaNumericOnly(int length) throws IllegalArgumentException;
 }