Merge branch 'master_ms'

docs/examples/rando.md

@@ -4,6 +4,6 @@ Generate a random coordinate and display it on the LED screen.
 
 ```blocks
 basic.forever(() => {
-    led.toggle(Math.randomRange(0, 5), Math.randomRange(0, 5))
+    led.toggle(Math.randomRange(0, 4), Math.randomRange(0, 4))
 })
 ```

docs/projects/love-meter.md

@@ -3,7 +3,6 @@
 ## Introduction @unplugged
 
 Make a love meter, how sweet! The @boardname@ is feeling the love, then sometimes not so much!
-Tell everyone who you are. Show you name on the LEDs.
 
 ![Love meter banner message](/calliope/tutorials/05_love_meter_animation.gif)
 

docs/projects/snap-the-dot.md

@@ -8,13 +8,19 @@ Snap the dot is a game of skill where the player has to press **A** exactly when
 
 This tutorial shows how to use the game engine.
 
-## Create a sprite @fullscreen
+## Make a sprite variable @fullscreen
 
-Drag a ``||game:create sprite||`` block onto the workspace. A sprite is a single pixel that can move on the screen. It has an ``x`` and ``y`` position along with a direction of motion.
+Create a new variable called `sprite`. Drag a ``||variables:set sprite to||`` into the ``||basic:on start||`` on the workspace. 
 
 ```blocks
-let sprite: game.LedSprite = null
-sprite = game.createSprite(2, 2)
+let sprite = 0
+```
+## Create a sprite @fullscreen
+
+Pull out a ``||game:create sprite||`` block and put it in ``||variables:set sprite to||`` replacing the `0`. A sprite is a single pixel that can move on the screen. It has an ``x`` and ``y`` position along with a direction of motion.
+
+```blocks
+let sprite = game.createSprite(2, 2)
 ```
 
 ## Move the dot @fullscreen
@@ -22,8 +28,7 @@ sprite = game.createSprite(2, 2)
 The sprite starts in the center facing right. Put a ``||game:move||`` block into the ``||basic:forever||`` to make it move. Notice how it moves to the right but does not bounce back.
 
 ```blocks
-let sprite: game.LedSprite = null
-sprite = game.createSprite(2, 2)
+let sprite = game.createSprite(2, 2)
 basic.forever(function () {
     sprite.move(1)
 })
@@ -34,8 +39,7 @@ basic.forever(function () {
 Grab a ``||game:if on edge, bounce||`` block to make the sprite bounce on the side of the screen. Also, add a ``||basic:pause||`` block to slow down the sprite.
 
 ```blocks
-let sprite: game.LedSprite = null
-sprite = game.createSprite(2, 2)
+let sprite = game.createSprite(2, 2)
 basic.forever(function () {
     sprite.move(1)
     sprite.ifOnEdgeBounce()
@@ -60,7 +64,6 @@ input.onButtonEvent(Button.A, ButtonEvent.Click, function () {
     } else {
     }
 })
-sprite = game.createSprite(2, 2)
 basic.forever(function () {
     sprite.move(1)
     basic.pause(100)
@@ -81,7 +84,6 @@ input.onButtonEvent(Button.A, ButtonEvent.Click, function () {
         game.gameOver()
     }
 })
-sprite = game.createSprite(2, 2)
 basic.forever(function () {
     sprite.move(1)
     basic.pause(100)

docs/reference/led/plot-bar-graph.md

@@ -17,6 +17,15 @@ A bar graph is a kind of chart that shows numbers as lines with different length
 * **high**: a [number](/types/number) that is the highest
   possible number (maximum) that the **value** parameter can be. The lines in the bar graph will reach their highest point when **value** reaches this number. If **high** is `0`, then the largest value recently plotted is used as the maximum.
 
+### ~hint
+
+#### Serial Output
+
+The ``||led:plot bar graph||`` block also writes the number from **value** to the [serial](/reference/serial) port as a way to help you record
+values.
+
+### ~
+
 ## Example: chart acceleration
 
 Show a bar graph of the [acceleration](/reference/input/acceleration)