2.1.28, initiation update to PXT v5.28.24 (#54)

docs/reference/input/on-button-pressed.md

@@ -5,11 +5,18 @@ This handler works when button `A` or `B` is pressed, or `A` and `B` together.
 When you are using this function in a web browser, click the buttons on the screen instead of the ones
 on the @boardname@.
 
+* For button `A` or `B`: This handler works when the button is pushed down and released within 1 second.
+* For `A` and `B` together: This handler works when `A` and `B` are both pushed down, then one of them is released within 1.5 seconds of pushing down the second button.
+
 ```sig
 input.onButtonPressed(Button.A, () => {})
 ```
 
-### Example: count button clicks
+Find out how buttons provide input to the @boardname@ in this video:
+
+https://www.youtube.com/watch?v=t_Qujjd_38o
+
+## Example: count button clicks
 
 This example counts how many times you press the `A` button. 
 Each time you press the button, the [LED screen](/device/screen) shows the `count` variable getting bigger.
@@ -23,25 +30,25 @@ input.onButtonPressed(Button.A, () => {
 })
 ```
 
-### Example: roll dice
+## Example: roll dice
 
 This example shows a number from 1 to 6 when you press the `B` button.
 
 ```blocks
 input.onButtonPressed(Button.B, () => {
-    let dice = Math.random(6) + 1
+    let dice = Math.randomRange(0, 5) + 1
     basic.showNumber(dice)
 })
 ```
 
-### ~hint
+## ~hint
 
-This program adds a `1` to `random(6)` so the numbers on the dice will come out right.
+This program adds a `1` to `random(5)` so the numbers on the dice will come out right.
 Otherwise, sometimes they would show a `0`.
 
-### ~
+## ~
 
-### See also
+## See also
 
 [button is pressed](/reference/input/button-is-pressed), [forever](/reference/basic/forever), [random](/blocks/math)