diff --git a/src/scriptInterface.cpp b/src/scriptInterface.cpp
index e6f5606e..4438e2a5 100644
--- a/src/scriptInterface.cpp
+++ b/src/scriptInterface.cpp
@@ -13,7 +13,8 @@ static int random(lua_State* L)
     return 1;
 }
 /// random(min_value, max_value)
-/// Generate a random floating point number between the min and max value. Includes min and max as possible values.
+/// Generate a random floating point number uniformly distributed on the interval [min_value, max_value]. Meaning min_value and max_value included.
+/// For further information see: https://en.cppreference.com/w/cpp/numeric/random/uniform_real_distribution.
 /// (Floating point numbers are factional numbers, so 1.5, 2.333333, 3.141)
 REGISTER_SCRIPT_FUNCTION(random);
 
@@ -26,7 +27,7 @@ static int irandom(lua_State* L)
     return 1;
 }
 /// irandom(min_value, max_value)
-/// Generate a random integer number between the min and max value. Includes min and max as possible values.
+/// Generate a random integer number uniformly distributed on the interval [min_value, max_value]. Meaning min_value and max_value included.
 /// (Integer numbers are whole numbers, so 1, 2, 3, 5, 1400)
 REGISTER_SCRIPT_FUNCTION(irandom);