NoIssue: Better documentation

src/main/java/com/r35157/libs/random/RandomValueGeneratorInt.java

@@ -0,0 +1,21 @@
+package com.r35157.libs.random;
+
+/**
+ * This interface provides a way to generate random integers.
+ */
+public interface RandomValueGeneratorInt {
+    /**
+     * Returns a random integer in the full range (min -2<sup>31</sup>. to max 2<sup>31</sup>-1)
+     *
+     * @return a random integer in full range
+     */
+    int getSomeInt();
+
+    /**
+     * Returns a random integer in the range provided by the parameters. Both parameters are included in the range and
+     * {@code minInclusive} must be less than {@code maxInclusive}.
+     *
+     * @return a random integer in the provided range
+     */
+    int getSomeInt(int minInclusive, int maxInclusive);
+}

src/main/java/com/r35157/libs/random/RandomValueGeneratorString.java

@@ -0,0 +1,14 @@
+package com.r35157.libs.random;
+
+import org.jetbrains.annotations.NotNull;
+
+public interface RandomValueGeneratorString {
+    /**
+     * 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;
+}

src/main/java/com/r35157/libs/random/SomeInterface.java

@@ -1,6 +0,0 @@
-package com.r35157.libs.random;
-
-public interface SomeInterface {
-    String concat(String x, String y);
-    void divideByZero() throws ArithmeticException;
-}