Refine comments for clarity and detail in random number generation logic

Author: rahanasuleiman8-ship-it

Sprint-2/1-key-exercises/4-random.js

@@ -1,21 +1,31 @@
 const minimum = 1; // Sets the lowest possible number that can be generated
 const maximum = 100; // Sets the highest possible number that can be generated
 
-
 // In this exercise, you will need to work out what num represents?
 // Try breaking down the expression and using documentation to explain what it means
 // It will help to think about the order in which expressions are evaluated
 
-const num = Math.floor(Math.random() * (maximum - minimum + 1)) + minimum; // calculates the total number of possible values between minimum and maximum, inclusive.
-// Multiplying Math.random() by this total count of numbers gives a random float from 0 up to (but not including) that count.
-// Adding + minimum at the end shifts the whole set of numbers up so that the lowest possible value becomes minimum rather than 0.
+const num = Math.floor(Math.random() * (maximum - minimum + 1)) + minimum;
+
+/*
+EXPLANATION IN ORDER OF EXECUTION (OPERATOR PRECEDENCE):
+
+1. (maximum - minimum + 1) — Grouping Parentheses (Highest Precedence):
+   Calculates the total number of possible whole values between minimum and maximum, inclusive (e.g., 100 - 1 + 1 = 100 possible values).
+
+2. Math.random() — Function Call:
+   Generates a random floating-point decimal from 0 up to (but not including) 1.
+
+3. Math.random() * (maximum - minimum + 1) — Multiplication:
+   calculates the total number of possible values between minimum and maximum, (but not including) 100 (e.g., 0 to 99.999...).
+
+4. Math.floor(...) — Function Call:
+   Rounds up the decimal to the nearest whole number, giving a whole number from 0 to 99.
 
-2
-// Math.random() returns a random decimal between 0 and 1
-// Math.random() * maximum(100) returns a random decimal between 0 and 99.999  
-// Math.floor() rounds up the decimal to the nearest whole number
-// maximum and minimum calculates thee total output of the number(100)
+5. + minimum — Addition (Lowest Precedence):
+   Shifts the whole set of numbers up so that the lowest outcome becomes `minimum` (1) instead of 0, resulting in a whole number between 1 and 100 inclusive.
+*/
 
 // Try logging the value of num and running the program several times to build an idea of what the program is doing
 
-console.log(num); // num represents a random whole number between 1 and 100 
+console.log(num); // num represents a random whole number between 1 and 100 inclusive