update random range to randint (#2993)

* update random range

* fix typo I noticed while sanity checking

Co-authored-by: Richard Knoll <[email protected]>

Author: jwunderl

docs/blocks/logic/boolean.md

@@ -18,10 +18,10 @@ When you compare two Numbers, you get a Boolean value, such as the comparison `x
 
 ```blocks
 input.onButtonPressed(Button.A, () => {
-    let x = Math.randomRange(0, 5)
+    let x = randint(0, 5)
     if(x < 5) {
     basic.showString("low");
-    } else { 
+    } else {
     basic.showString("high");
     }
 })

docs/courses/blocks-to-javascript/complex-conditionals.md

@@ -5,7 +5,7 @@
 Sometimes there is code you want to run if two or more conditions are true. The ``||logic:if then||`` block lets you combine conditions with the ``||logic:and||`` and the ``||logic:or||`` blocks. For example, if we want to see if a random number is between `0` and `9`, we can put two conditions in an ``||logic:if then||`` and connect them with an ``||logic:and||``.
 
 ```blocks
-let rando = Math.randomRange(-20, 20)
+let rando = randint(-20, 20)
 if (rando >= 0 && rando < 10) {
     basic.showNumber(rando)
 }
@@ -14,7 +14,7 @@ if (rando >= 0 && rando < 10) {
 This is how to check if a result is within a range of values, in this case it's from `0` to `9`. What if we want to include the values between `15` and `18` too? We just add another range check and connect them with an ``||logic:or||``.
 
 ```blocks
-let rando = Math.randomRange(-20, 20)
+let rando = randint(-20, 20)
 if ((rando >= 0 && rando < 10) || (rando >= 15 && rando < 18)) {
     basic.showNumber(rando)
 }
@@ -23,7 +23,7 @@ if ((rando >= 0 && rando < 10) || (rando >= 15 && rando < 18)) {
 Having all of these conditions in one ``||logic:if then||`` makes a large and complicated block. It can be hard to see how the complete conditional does both of the range checks. At times, it's easier to read the code in the JavaScript editor to better see the order and connections of the conditions.
 
 ```typescript
-let rando = Math.randomRange(-20, 20)
+let rando = randint(-20, 20)
 if ((rando >= 0 && rando < 10) || (rando >= 15 && rando < 18)) {
     basic.showNumber(rando)
 }
@@ -36,7 +36,7 @@ As you can see, reading the code for this conditional is might seem easier in Ja
 If one ``||logic:if then||`` block is placed inside another, then each condition for checking the random number is placed in its own ``||logic:if then||``. This give the same result as before with the two conditions in the ``||logic:if then||``.
 
 ```block
-let rando = Math.randomRange(-20, 20)
+let rando = randint(-20, 20)
 if (rando >= 0) {
     if (rando < 10) {
         basic.showNumber(rando)
@@ -47,7 +47,7 @@ if (rando >= 0) {
 When we switch the editor to JavaScript view, we see that the second ``if ()`` statement is indented and contained inside the `{ }` of the first. This matches the second ``||logic:if then||`` block that fits inside the first one. These are called _nested_ if statements.
 
 ```typescript
-let rando = Math.randomRange(-20, 20)
+let rando = randint(-20, 20)
 if (rando >= 0) {
     if (rando < 10) {
         basic.showNumber(rando)
@@ -138,4 +138,4 @@ To set the variable based on the result of the expression, the value options are
 let heatMessage = input.temperature() < 10 ? "COLD" : "WARM"
 ```
 
-The ``heatMeassage`` variable is set to the string saying ``"COLD"`` if the temperature is less than `10` degrees celsius or to ``"WARM"`` when it's `10` degrees or warmer. 
+The ``heatMeassage`` variable is set to the string saying ``"COLD"`` if the temperature is less than `10` degrees celsius or to ``"WARM"`` when it's `10` degrees or warmer.

docs/courses/csintro/arrays/activity.md

@@ -6,12 +6,12 @@ Create an array of words that can be used as part of a charades-type game.
 This activity is based on a very popular phone app invented by Ellen DeGeneres (https://bits.blogs.nytimes.com/2013/05/03/ellen-degeneres-iphone-game/).
 
 ![Heads up game](/static/courses/csintro/arrays/headband-charades.png)
-	
+
 * Create a new variable and give it a name like arrayWords.
-* Insert a 'set' variable block into the 'on start' block. 
+* Insert a 'set' variable block into the 'on start' block.
 * Change the default variable name to this new variable name.
 * From the Array Toolbox drawer, drag an 'array of' block to the coding workspace.
-* Attach this array block to the end of the 'set' variable block. 
+* Attach this array block to the end of the 'set' variable block.
 
 ```blocks
 let arrayWords = ["", ""]
@@ -28,12 +28,12 @@ let arrayWords = ["", "", "", "", "", "", ""]
 ```
 * Fill each string with one word. Choose words that will be fun for a game of charades. Example:
 
-```blocks	
+```blocks
 let arrayWords = ["cat", "guitar", "flashlight", "cupcake", "tree", "frisbee"]
 ```
 
 Now, we need a way to access one word at a time from this array of words.
-* We can use the 'show string' block from the Basic Toolbox drawer, and the 'on screen up' event handler from the Input Toolbox drawer (this is a drop-down menu choice of the 'on shake' block) to tell the micro:bit to display a word when we tilt the micro:bit up. 
+* We can use the 'show string' block from the Basic Toolbox drawer, and the 'on screen up' event handler from the Input Toolbox drawer (this is a drop-down menu choice of the 'on shake' block) to tell the micro:bit to display a word when we tilt the micro:bit up.
 * For this version, we’ll display the words one at a time in the order they were first placed into the array.
 * We’ll use the index of the array to keep track of what word to display at any given time, so you'll need to create an 'index' variable.
 
@@ -89,7 +89,7 @@ input.onGesture(Gesture.ScreenDown, () => {
 We have a limited number of elements in our array, so to avoid an error, we need to check and make sure we are not already at the end of the array before we change the index.
 
 * Under the Arrays Toolbox drawer, drag out a 'length of' block. The 'length of' block returns the number of items (elements) in an array. For our array, the length of block will return the value 6.
-* But because computer programmers start counting at zero, the index of the final (6th) element is 5. 
+* But because computer programmers start counting at zero, the index of the final (6th) element is 5.
 
 Some pseudocode for our algorithm logic:
 * When the player places the micro:bit screen down:
@@ -141,9 +141,9 @@ input.onGesture(Gesture.ScreenDown, () => {
 ## Game Play
 There are different ways you can play charades with our program.  Here is one way you can play with a group of friends.
 
-* With the micro:bit on and held so Player A cannot see the screen, another player starts the program to see the first word. 
+* With the micro:bit on and held so Player A cannot see the screen, another player starts the program to see the first word.
 * The other players act out this word charades-style for Player A to guess.
-* When Player A guesses correctly or decides to pass on this word, a player places the micro:bit screen down. 
+* When Player A guesses correctly or decides to pass on this word, a player places the micro:bit screen down.
 * When ready for the next word, a player turns the micro:bit screen up. Play continues until all the words in the array have been used.
 
 ## Mod this!
@@ -197,15 +197,15 @@ Review the use of the random block in the Math category.
 * Create a block that will plot a single dot at a random location on the screen by choosing a random number from 0 to 4 for the x axis and a random number from 0 to 4 for the y axis.
 
 ```blocks
-led.plot(Math.randomRange(0, 5), Math.randomRange(0, 5))
+led.plot(randint(0, 4), randint(0, 4))
 ```
 
 Next, let’s create a loop that will repeat the above code five times, for a constellation with five stars.
 
 ```blocks
 for (let index = 0; index <= 4; index++) {
-    led.plot(Math.randomRange(0, 5), Math.randomRange(0, 5))
-    }
+    led.plot(randint(0, 4), randint(0, 4))
+}
 ```
 
 Note that to keep things simple we don’t check for duplicates, so it’s possible you may end up with fewer than five visible stars. That’s okay.
@@ -233,13 +233,13 @@ To fix this, we need to do a little math by subtracting 1 from whatever the valu
 let list = [5, 2, 1, 3, 4]
 
 for (let index = 0; index < list[0] - 1; index++) {
-    led.plot(Math.randomRange(0, 5), Math.randomRange(0, 5))
+    led.plot(randint(0, 4), randint(0, 4))
 }
 ```
 
 The above code takes the first value in the array and creates that many stars at random locations. Now, all we need to do is iterate through the entire array and do the same thing for each of the values. We will put the above code inside another loop that will run the same number of times as the length of the array (in this case, 5). You should also use a 'pause' block and a 'clear screen' block in between each constellation.
 
-Finally, you might attach the code that shows the constellations to an 'on button A pressed' event handler. 
+Finally, you might attach the code that shows the constellations to an 'on button A pressed' event handler.
 
 Here is the complete program.
 
@@ -248,7 +248,7 @@ let list: number[] = []
 input.onButtonPressed(Button.A, () => {
     for (let i = 0; i <= list.length - 1; i++) {
         for (let j = 0; j <= list[i] - 1; j++) {
-            led.plot(Math.randomRange(0, 5), Math.randomRange(0, 5))
+            led.plot(randint(0, 4), randint(0, 4))
         }
         basic.pause(1000)
         basic.clearScreen()

docs/courses/csintro/arrays/unplugged.md

@@ -18,8 +18,8 @@ In this activity, you will demonstrate different kinds of sorting methods on you
 * Ask the Sorter to place the students in order by directing them to move, one at a time, to the proper place.
 * Once the students are sorted, ask students the following:
 
->*  How did she sort you into the right order? 
-* Did you see a pattern? 
+>*  How did she sort you into the right order?
+* Did you see a pattern?
 * What did she do?
 
 Try to get students to be as precise as possible in explaining their thinking. Sometimes it helps to put the steps on the board, in an algorithm:
@@ -62,7 +62,7 @@ let column = 0
 let index = 0
 input.onButtonPressed(Button.AB, () => {
     for (let index = 0; index <= 4; index++) {
-        list[index] = Math.randomRange(0, 5) + 1
+        list[index] = randint(0, 5) + 1
     }
 })
 input.onButtonPressed(Button.B, () => {
@@ -142,7 +142,7 @@ input.onButtonPressed(Button.B, () => {
 })
 input.onButtonPressed(Button.AB, () => {
     for (let index = 0; index <= 4; index++) {
-        list[index] = Math.randomRange(0, 5) + 1
+        list[index] = randint(0, 5) + 1
     }
 })
 input.onButtonPressed(Button.A, () => {
@@ -223,7 +223,7 @@ input.onButtonPressed(Button.A, () => {
 })
 input.onButtonPressed(Button.AB, () => {
     for (let index = 0; index <= 4; index++) {
-        list[index] = Math.randomRange(0, 5) + 1
+        list[index] = randint(0, 5) + 1
     }
 })
 input.onButtonPressed(Button.B, () => {

docs/courses/csintro/booleans/project.md

@@ -2,7 +2,7 @@
 
 ![Two-Player Game Example Board](/static/courses/csintro/booleans/two-player.jpg)
 
-This is an assignment for students to come up with a micro:bit program that uses Boolean variables, Boolean operators, and possibly the random function. 
+This is an assignment for students to come up with a micro:bit program that uses Boolean variables, Boolean operators, and possibly the random function.
 
 ## Input
 Remind the students of all the different inputs available to them through the micro:bit.
@@ -205,7 +205,7 @@ let player1Turn = false
 let spin = 0
 let delay = 0
 input.onGesture(Gesture.Shake, () => {
-    if (player1Turn == true && Math.randomRange(0, 4) < 3) {
+    if (player1Turn == true && randint(0, 4) < 3) {
         basic.clearScreen()
         delay = 0
         while (delay < 500) {
@@ -250,7 +250,7 @@ input.onGesture(Gesture.Shake, () => {
     } else if (player1Turn) {
         basic.showString("Crash!")
         player1Turn = false
-    } else if (Math.randomRange(0, 4) < 3) {
+    } else if (randint(0, 4) < 3) {
         basic.clearScreen()
         delay = 0
         while (delay < 500) {
@@ -298,7 +298,7 @@ input.onGesture(Gesture.Shake, () => {
     }
 })
 basic.forever(() => {
-	
+
 })
 delay = 0
 spin = 0
@@ -314,7 +314,7 @@ Here is a portion of the board game's code. A boolean variable is used to determ
 ```blocks
 let player1Turn = false;
 input.onGesture(Gesture.Shake, () => {
-    if (player1Turn == true && Math.randomRange(0, 4) < 3) {
+    if (player1Turn == true && randint(0, 4) < 3) {
 
     }
 })
@@ -353,4 +353,4 @@ Have students write a reflection of about 150–300 words, addressing the follow
 **4 =** Reflection piece addresses all prompts.<br/>
 **3 =** Reflection piece lacks 1 of the required elements.<br/>
 **2 =** Reflection piece lacks 2 of the required elements.<br/>
-**1 =** Reflection piece lacks 3 of the required elements. 
+**1 =** Reflection piece lacks 3 of the required elements.

docs/courses/csintro/conditionals/activity.md

@@ -1,6 +1,6 @@
 # Activity: Rock, paper, scissors
 
-For this activity, each student will need a micro:bit. 
+For this activity, each student will need a micro:bit.
 Everyone will create the same program, the classic rock paper scissor game.
 
 ![Rock, paper, scissors](/static/courses/csintro/conditionals/rock-paper-scissors-items.png)
@@ -14,7 +14,7 @@ Everyone will create the same program, the classic rock paper scissor game.
 >Example pseudocode:<br/>
 On button A press: choose random number from 0-2
 If random number = 0, then display rock icon,
-Else if random number = 1, then display paper icon, 
+Else if random number = 1, then display paper icon,
 Else display scissors icon.
 * Point out that because there are only three possibilities, we don’t need to do a separate check to see if random number = 2. So we just use an else.
 
@@ -34,7 +34,7 @@ Here's an example mod:
 ```blocks
 let hand = 0
 input.onGesture(Gesture.Shake, () => {
-    hand = Math.randomRange(0, 3)
+    hand = randint(0, 3)
     if (hand == 0) {
         basic.showLeds(`
             # # # # #