0.2.41

.travis.yml

@@ -3,6 +3,7 @@ node_js:
   - "5.7.0"
 script:
   - "node node_modules/kindscript/built/kind.js travis"  
+  - "(cd libs/lang-test0; node ../../node_modules/kindscript/built/kind.js run)"
   - "node node_modules/kindscript/built/kind.js uploaddoc"
 sudo: false
 notifications:

docs/about.md

@@ -1,3 +1,8 @@
+```sim
+basic.forever(() => {
+  basic.showString("Hi!");
+})
+``` 
 # About
 
 The [BBC micro:bit](https://www.microbit.co.uk) is a [pocket-size computer](/device) with a 5x5 display of 25 LEDs, Bluetooth and sensors that can be programmed by anyone.

docs/device/usb.md

@@ -1,6 +1,6 @@
 # Run Scripts on your micro:bit
 
-How to compile, transfer, and run a script on your micro:bit. #docs #USB #compile #transfer
+How to compile, transfer, and run a script on your micro:bit.
 
 While you're writing and testing your Block Editor or Touch Develop scripts, you'll mostly be running scripts in your browser by clicking the `Run` button (see [run code in your browser](/microbit/js/simulator) for info about this).
 

docs/lessons.md

@@ -1,5 +1,6 @@
 # Lessons 
 
+
 ### @short Lessons
 
 ### ~column 

docs/lessons/answering-machine.md

@@ -22,12 +22,9 @@ Learn how to creating a message with a **string**, `show string` to write your m
 
 ## Documentation
 
-```docs
+```cards
 basic.showString('Hi!')
-
-input.onButtonPressed(Button.A, () => {
-    
-})
+input.onButtonPressed(Button.A, () => {})
 
 ```
 

docs/lessons/answering-machine/quiz-answers.md

@@ -1,6 +1,6 @@
 # answering machine blocks quiz answers
 
-Create an answering machine on the micro:bit. #LED #screen #show #math #docs #input
+Create an answering machine on the micro:bit.
 
 This is the answer key for the [answering machine quiz](/microbit/lessons/answering-machine/quiz).
 

docs/lessons/answering-machine/quiz.md

@@ -1,6 +1,6 @@
 # answering machine blocks quiz
 
-Create an answering machine on the micro:bit. #LED #screen #show #math #docs #input
+Create an answering machine on the micro:bit.
 
 ## Name
 

docs/lessons/banana-keyboard.md

@@ -1,6 +1,6 @@
 # banana keyboard blocks lesson
 
-display beautiful images on the BBC micro:bit #var #pause #docs
+display beautiful images on the BBC micro:bit.
 
 ## Topic
 

docs/lessons/banana-keyboard/activity.md

@@ -81,3 +81,9 @@ Your banana keyboard is ready!
 
 Connect your micro:bit to your computer using your USB cable and run the [banana keyboard](/microbit/lhpkbr) script on it. Tap your banana instrument to play sound against... the fruit!
 
+
+### ~avatar boothing
+
+Excellent, you're ready to continue with the [challenges](/microbit/lessons/banana-keyboard/challenges)!
+
+### ~

docs/lessons/beatbox.md

@@ -1,6 +1,6 @@
 # beatbox blocks lesson
 
-display beautiful images on the BBC micro:bit #var #pause #docs
+display beautiful images on the BBC micro:bit.
 
 ## Topic
 

docs/lessons/beautiful-image.md

@@ -1,6 +1,6 @@
 # beautiful image lesson
 
-display beautiful images on the BBC micro:bit #var #pause #docs
+display beautiful images on the BBC micro:bit.
 
 ### @video td/videos/beautiful-image-0
 
@@ -20,7 +20,7 @@ Learn how to **show LEDs**,  to show an image on the BBC micro:bit's LED screen.
 
 ## Documentation
 
-```docs
+```cards
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -28,10 +28,7 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
-
 basic.pause(100)
-
 ```
 
 ## Objectives

docs/lessons/beautiful-image/activity.md

@@ -1,6 +1,6 @@
 # beautiful image blocks activity
 
-Generate and show a beautiful image. #docs #microbit
+Generate and show a beautiful image.
 
 ### ~avatar avatar
 

docs/lessons/blink.md

@@ -1,6 +1,6 @@
 # blink blocks lesson
 
-Learn how to create a blinking LED. #LED #screen  #plot #docs #lesson
+Learn how to create a blinking LED.
 
 ### @video td/videos/blink-0
 
@@ -23,18 +23,11 @@ Learn how to control a blinking LED. We will be learning how to create a blinkin
 
 ## Documentation
 
-```docs
+```cards
 led.plot(0, 0)
-
 led.unplot(0, 0)
-
 basic.pause(100)
-
-basic.forever(() => {
-    
-})
-
-
+basic.forever(() => {})
 ```
 
 

docs/lessons/blink/quiz-answers.md

@@ -1,6 +1,6 @@
 # blink blocks quiz answers
 
-Learn how to create a blinking LED script. #LED #screen  #plot #docs
+Learn how to create a blinking LED script.
 
 This is the answer key for the [blink quiz](/microbit/lessons/blink/quiz).
 

docs/lessons/blink/quiz.md

@@ -1,6 +1,6 @@
 # blink blocks quiz
 
-Learn how to create a blinking LED script. #LED #screen  #plot #docs
+Learn how to create a blinking LED script.
 
 ## Name
 

docs/lessons/bop-it/quiz-answers.md

@@ -1,6 +1,6 @@
 # bop it quiz answers
 
-a game where you have to keep up with the commands #math #random #docs
+a game where you have to keep up with the commands.
 
 ## Name
 

docs/lessons/bop-it/quiz.md

@@ -1,6 +1,6 @@
 # bop it quiz 
 
-a game where you have to keep up with the commands #math #random #docs
+a game where you have to keep up with the commands.
 
 ## Name
 

docs/lessons/catch-the-egg-game.md

@@ -1,6 +1,6 @@
 # catch the egg game lesson
 
-a game to catch eggs in a basket #var #data #if #random #min #max #mod #plot #unplot #pause #accceleration #docs
+A game to catch eggs in a basket.
 
 ### @video td/videos/catch-the-egg-game-0
 

docs/lessons/catch-the-egg-game/activity.md

@@ -56,9 +56,9 @@ basic.forever(() => {
     }
     if (eggY1 == 4) {
         if (basketX1 == eggX1) {
-            game.addScore(1) // ***
+            game.addScore(1) 
         } else {
-            game.removeLife(1) // ***
+            game.removeLife(1)
         }
     }
     basic.pause(300)
@@ -142,7 +142,7 @@ basic.forever(() => {
             game.removeLife(1)
         }
     }
-    basic.pause(fallingPause1) // ***
+    basic.pause(fallingPause1) 
 })
 
 ```

docs/lessons/charting.md

@@ -1,6 +1,6 @@
 # charting lesson
 
-measure the acceleration on the micro:bit in the "z" direction #acceleration #var #docs #if #show
+Measure the acceleration on the micro:bit in the "z" direction.
 
 ## Topic
 
@@ -17,23 +17,13 @@ Learn the functions of **on data received**, **send number** and **receive numbe
 
 ## Documentation
 
-```docs
-
+```cards
 basic.showNumber(0)
-
 input.acceleration(Dimension.X)
-
 led.plotBarGraph(0, 1023)
-
-radio.onDataReceived(() => {
-
-
-})
-
+radio.onDataReceived(() => {})
 radio.sendNumber(0)
-
 radio.receiveNumber()
-
 ```
 
 ## Objectives

docs/lessons/charting/activity.md

@@ -13,15 +13,17 @@ Welcome! This activity will teach how to use the 1st micro:bit to chart the seco
 Let's measure `acceleration (mg)` and then `send number`. `Acceleration` is measured in **milli-gravities**, so a value of -1000 is equivalent to -1g or -9.81m/s^2. We will be able to get the acceleration value (g-force), in the specified "x" dimension. `Send number` will broadcast a number data packet to other micro:bits connected via radio.
 
 ```blocks
-radio.sendNumber(input.acceleration(Dimension.X))
+radio.sendNumber(input.acceleration(Dimension.X));
 ```
 
 We want to display the acceleration forever. In order to do so, we need a `forever` loop. A forever loop will repeat code in the background forever.
 
 ```blocks
 basic.forever(() => {
-    radio.sendNumber(input.acceleration(Dimension.X))
-})
+    radio.sendNumber(input.acceleration(Dimension.X));
+});
+
+
 ```
 
 We want to register code to run when a packet is received over radio. We can implement this code by adding `on data received`.

docs/lessons/classic-beatbox.md

@@ -1,6 +1,6 @@
 # classic beatbox 
 
-display beautiful images on the BBC micro:bit #var #pause #docs
+display beautiful images on the BBC micro:bit.
 
 ## Topic
 

docs/lessons/compass.md

@@ -1,6 +1,6 @@
 # compass lesson
 
-create a die on the BBC micro:bit #button #pressed #math #random #var #string #if #docs
+create a die on the BBC micro:bit.
 
 ### @video td/videos/compass-0
 
@@ -21,17 +21,12 @@ Learn how to use an if statements to run code run code depending on whether a co
 
 ## Documentation
 
-```docs
+```cards
 input.compassHeading()
-
 basic.forever(() => {})
-
 let x = 0
-
 if (true) {}
-
 basic.showString("Hello!")
-
 basic.showLeds(`
     . . . . .
     . . . . .

docs/lessons/counter.md

@@ -1,6 +1,6 @@
 # counter lesson
 
-Learn how to create a counter with with on button pressed. #show #number #screen  #number #math #docs
+Learn how to create a counter with with on button pressed.
 
 ### @video td/videos/counter-0
 
@@ -21,22 +21,12 @@ Learn how to creating a **variable** to keep track of the current count. We will
 
 ## Documentation
 
-```docs
+```cards
 input.compassHeading()
-
-basic.forever(() => {
-
-
-})
-
+basic.forever(() => {})
 let x = 0
-
-if (true) {
-
-}
-
+if (true) {}
 basic.showString("Hello!")
-
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -44,7 +34,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
 ```
 
 * **variable**: [read more...](/microbit/reference/variables/var)

docs/lessons/die-roll.md

@@ -1,6 +1,6 @@
 # die roll lesson
 
-create a die on the BBC micro:bit #button #pressed #math #random #var #string #if #docs
+create a die on the BBC micro:bit.
 
 ### @video td/videos/die-roll-0
 
@@ -21,21 +21,11 @@ Learn how to use an if statements to run code run code depending on whether a co
 
 ## Documentation
 
-```docs
-
-input.onGesture(Gesture.Shake, () => {
-
-})
-
-
-
+```cards
+input.onGesture(Gesture.Shake, () => {})
 let x = 0
-x = Math.random(3)
-
-if (true) {
-
-}
-
+Math.random(3)
+if (true) {}
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -43,10 +33,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
-
-
-
 ```
 
 ## Objectives

docs/lessons/digi-yoyo.md

@@ -1,6 +1,6 @@
 # digi yoyo lesson
 
-create a counter with a while loop #while #loop #counter #docs
+create a counter with a while loop.
 
 ### @video td/videos/digi-yoyo-0
 
@@ -21,13 +21,11 @@ Learn how to creating a **while loop**, `while condition do` to repeat code whil
 
 ## Documentation
 
-```docs
+```cards
 let x = 0
 basic.showNumber(0)
-while (true) {
-
-    basic.pause(20)
-}
+while (true) {}
+basic.pause(20)
 ```
 
 ## Objectives

docs/lessons/flashing-heart.md

@@ -1,6 +1,6 @@
 # flashing heart blocks lesson
 
-Learn how to create LED images with a global variable. #LED #screen  #plot #docs
+Learn how to create LED images with a global variable.
 
 ### @video td/videos/flashing-heart-0
 
@@ -20,13 +20,8 @@ Learn how to `show LEDs` by showing an image on the LED screen. We will be learn
 
 ## Documentation
 
-```docs
-basic.forever(() => {
-
-
-})
-
-
+```cards
+basic.forever(() => {})
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -34,11 +29,8 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
 basic.pause(100)
-
 basic.clearScreen()
-
 ```
 
 ## Objectives

docs/lessons/game-counter.md

@@ -1,6 +1,6 @@
 # game counter lesson
 
-Learn how to create a counter with with on button pressed. #show #number #screen  #number #math #docs
+Learn how to create a counter with with on button pressed.
 
 ### @video td/videos/counter-0
 
@@ -19,15 +19,10 @@ Learn how to create game blocks to keep track of the current score. We will be l
 
 ## Documentation
 
-```docs
+```cards
 game.addScore(1)
-
-input.onButtonPressed(Button.A, () => {
-
-})
-
+input.onButtonPressed(Button.A, () => {})
 basic.showNumber(0)
-
 ```
 
 ## Objectives

docs/lessons/game-of-chance.md

@@ -18,15 +18,10 @@ Learn how to creating a message with a **game over** to write your message. We w
 ## Documentation
 
 
-```docs
+```cards
 game.gameOver()
-
 basic.showString("Hello!")
-
-input.onButtonPressed(Button.A, () => {
-    
-})
-
+input.onButtonPressed(Button.A, () => {})
 ```
 
 ## Objectives

docs/lessons/glowing-pendulum.md

@@ -1,6 +1,6 @@
 # glowing pendulum blocks lesson
 
-construct a pendulum that glows using acceleration #var #acceleration #abs #brightness #plot #docs
+construct a pendulum that glows using acceleration.
 
 ## Topic
 
@@ -19,21 +19,12 @@ Learn how to get the acceleration **acceleration**, `acceleration` value (g-forc
 
 ## Documentation
 
-```docs
-
-basic.forever(() => {
-
-
-})
-
+```cards
+basic.forever(() => {})
 let x = 0
-
 input.acceleration(Dimension.X)
-
 Math.abs(0)
-
 led.setBrightness(255)
-
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -41,7 +32,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
 ```
 
 ## Objectives

docs/lessons/glowing-pendulum/quiz-answers.md

@@ -1,6 +1,6 @@
 # glowing pendulum quiz answers
 
-construct a pendulum that glows using acceleration #LED #number #math #acceleration #docs
+construct a pendulum that glows using acceleration.
 
 ## Name
 

docs/lessons/glowing-pendulum/quiz.md

@@ -1,6 +1,6 @@
 # glowing pendulum quiz
 
-construct a pendulum that glows using acceleration #LED #number #math #acceleration #docs
+construct a pendulum that glows using acceleration.
 
 ## Name
 

docs/lessons/glowing-sword.md

@@ -1,6 +1,6 @@
 # glowing sword blocks lesson
 
-make a glowing sword #image #docs
+make a glowing sword.
 
 ### @video td/videos/glowing-sword-0
 

docs/lessons/guess-the-number.md

@@ -1,6 +1,6 @@
 # guess the number lesson
 
-Learn to create a random number with input from button A. #input #screen #math #docs
+Learn to create a random number with input from button A.
 
 ### @video td/videos/guess-the-number-0
 
@@ -21,22 +21,12 @@ Learn how to create numbers randomly by using the input of the BBC micro:bit. We
 
 ## Documentation
 
-```docs
-
-input.onButtonPressed(Button.A, () => {
-
-
-})
-
+```cards
+input.onButtonPressed(Button.A, () => {})
 let x = 0
-
 basic.showNumber(0)
-
 Math.random(3)
-
 basic.clearScreen()
-
-
 ```
 
 ## Objectives

docs/lessons/guess-the-number/quiz-answers.md

@@ -1,6 +1,6 @@
 # guess the number quiz answers
 
-Learn how to generate a random number on the micro:bit. #math #random #docs
+Learn how to generate a random number on the micro:bit.
 
 This is the answer key for the [guess the number quiz](/microbit/lessons/guess-the-number/quiz).
 

docs/lessons/guess-the-number/quiz.md

@@ -1,6 +1,6 @@
 # guess the number quiz 
 
-Learn how to generate a random number on the micro:bit. #math #random #docs
+Learn how to generate a random number on the micro:bit.
 
 ## Name
 

docs/lessons/hack-your-headphones.md

@@ -1,6 +1,6 @@
 # hack your headphones lesson
 
-display beautiful images on the BBC micro:bit #var #pause #docs
+display beautiful images on the BBC micro:bit.
 
 ## Topic
 

docs/lessons/hack-your-headphones/activity.md

@@ -54,3 +54,8 @@ You hacked your headphones!
 
 Connect your micro:bit to your computer using your USB cable and program  [light beatbox](/microbit/lessons/light-beatbox/activity) music on it. Press the reset button to restart your music player!
 
+### ~avatar avatar
+
+Excellent, you're ready to continue with the [challenges](/microbit/lessons/light-beatbox/activity)!
+
+### ~

docs/lessons/happy-birthday.md

@@ -1,6 +1,6 @@
 # happy birthday blocks lesson
 
-display beautiful images on the BBC micro:bit #var #pause #docs
+display beautiful images on the BBC micro:bit.
 
 ## Topic
 

docs/lessons/headbands.md

@@ -1,6 +1,6 @@
 # headbands lesson
 
-create a charades game that can be played with your friends #data #string #collection #at #Boolean #on-logo-down #on-logo-up #running-time #string #number #docs
+create a charades game that can be played with your friends.
 
 ## Topic
 
@@ -8,10 +8,10 @@ Collection
 
 ## Quick Links
 
-* [tutorial](/microbit/lessons/headbands/tutorial)
+* [activity](/microbit/lessons/headbands/activity)
 * [quiz](/microbit/lessons/headbands/quiz)
 * [quiz answers](/microbit/lessons/headbands/quiz-answers)
-* [challenges](/microbit/lessons/headbands/challenges)
+
 
 ## Class
 

docs/lessons/headbands/activity.md

@@ -1,6 +1,4 @@
-# headbands challenges
-
-These challenges will teach you how to create a fun charades game to play with your friends. #docs
+# headbands activity
 
 ## Before we get started
 

docs/lessons/headbands/quiz-answers.md

@@ -1,12 +1,12 @@
 # headbands quiz answers
 
-create a charades game with a collection of strings #offset #screen  #variables #docs
+create a charades game with a collection of strings.
 
 ## Name
 
 ## Directions
 
-Use this activity document to guide your work in the [headbands tutorial](/microbit/lessons/headbands/tutorial).
+Use this activity document to guide your work in the [headbands tutorial](/microbit/lessons/headbands/activity).
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 

docs/lessons/headbands/quiz.md

@@ -1,12 +1,12 @@
 # headbands quiz
 
-create a charades game with a collection of strings #offset #screen  #variables #docs
+create a charades game with a collection of strings.
 
 ## Name
 
 ## Directions
 
-Use this activity document to guide your work in the [headbands tutorial](/microbit/lessons/headbands/tutorial).
+Use this activity document to guide your work in the [headbands tutorial](/microbit/lessons/headbands/activity).
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 

docs/lessons/hero.md

@@ -1,6 +1,6 @@
 # hero 
 
-make a game to test hand-eye coordination #docs #functions #var
+make a game to test hand-eye coordination.
 
 Make a game to test hand-eye coordination
 

docs/lessons/hero/activity.md

@@ -39,8 +39,14 @@ ghost.change(LedSpriteProperty.Blink, 100);
 
 We want to identify the food so the player moves towards the food. We need to set the `brightness` of the `variable` food to 8. The brightness of the LED screen is expressed as a number between 0 and 255.
 
-![](/static/mb/blocks/lessons/hero-3.png)
+```blocks
+let hero = game.createSprite(2, 2);
+let food = game.createSprite(4, 4);
+let ghost = game.createSprite(0, 0);
+ghost.change(LedSpriteProperty.Blink, 100);
+food = led.brightness() == 8;
 
+```
 
 We want to include a block from the Loops drawer called `While`. Then set the `While` loop to `true`. This code will be important for repeating code of the game logic of the game. The game will continue to run using `While` loop while the Boolean condition is true. Finally, include a `pause` of 400 milliseconds before the logic of the game begins.
 
@@ -50,52 +56,223 @@ let hero = game.createSprite(2, 2);
 let food = game.createSprite(4, 4);
 let ghost = game.createSprite(0, 0);
 ghost.change(LedSpriteProperty.Blink, 100);
+food = led.brightness() == 8;
 while (true) {
-    basic.pause(400)
+    basic.pause(400);
 }
+
+
 ```
 
 Let's create a function that will take care of keep the ghost pursuing the hero. We will need to a conditional statement that checks the position of the ghost and hero. The first condition will check if the horizontal coordinates of the ghost is less than the horizontal coordinates of the hero. We create a function from the Game drawer that will check the coordinates of the hero and the ghost. Finally, change the x-direction of the ghost by 1.
 
 Then create another function that will take care of keep the ghost pursuing the hero. We will need to a conditional statement that checks the position of the ghost and hero. The second condition will check if the horizontal coordinates of the ghost is greater than the x-direction of hero. We create a function from the Game drawer that will check the x-direction of hero and ghost. Finally, change the x-direction of the ghost by -1.
 
-![](/static/mb/blocks/lessons/hero-5.png)
+```blocks
+let hero = game.createSprite(2, 2);
+let food = game.createSprite(4, 4);
+let ghost = game.createSprite(0, 0);
+ghost.change(LedSpriteProperty.Blink, 100);
+food = led.brightness() == 8;
+while (true) {
+    basic.pause(400);
+    if (ghost.get(LedSpriteProperty.X) < hero.get(LedSpriteProperty.X)) {
+        ghost.change(LedSpriteProperty.X, 1);
+    }
+    else if (ghost.get(LedSpriteProperty.X) > hero.get(LedSpriteProperty.X)) {
+        ghost.change(LedSpriteProperty.X,  -1 );
+    }
+    else if (false) {
+    }
+    else if (false) {
+    }
+   
+}
+
+
+```
 
 Let's create the third function and forth function that continues the same logic in the y-direction of pacman and ghost. We create a function from the Game drawer that will check the y-direction of pacman and ghost. Finally, change the y-direction of the ghost to continue following pacman.
 
-![](/static/mb/blocks/lessons/hero-6.png)
+```blocks
+let hero = game.createSprite(2, 2);
+let food = game.createSprite(4, 4);
+let ghost = game.createSprite(0, 0);
+ghost.change(LedSpriteProperty.Blink, 100);
+food = led.brightness() == 8;
+while (true) {
+    basic.pause(400);
+    if (ghost.get(LedSpriteProperty.X) < hero.get(LedSpriteProperty.X)) {
+        ghost.change(LedSpriteProperty.X, 1);
+    }
+    else if (ghost.get(LedSpriteProperty.X) < hero.get(LedSpriteProperty.X)) {
+        ghost.change(LedSpriteProperty.X,  -1 );
+    }
+    else if (ghost.get(LedSpriteProperty.Y) < hero.get(LedSpriteProperty.Y)) {
+        ghost.change(LedSpriteProperty.Y, 1);
+    }
+    else if (ghost.get(LedSpriteProperty.Y) > hero.get(LedSpriteProperty.Y)) {
+        ghost.change(LedSpriteProperty.Y,  -1 );
+    }
+   
+}
+
+
+```
 
 Let's enable pacman to move in the x-direction and move in the y-direction with acceleration using the micor:bit sensor
 
-![](/static/mb/blocks/lessons/hero-7.png)
-
-**Do not disconnect the blocks for the conditional statements. We are focusing on this section of the code and are not showing the entire code**
+```blocks
+let hero = game.createSprite(2, 2);
+let food = game.createSprite(4, 4);
+let ghost = game.createSprite(0, 0);
+ghost.change(LedSpriteProperty.Blink, 100);
+food = led.brightness() == 8;
+while (true) {
+    basic.pause(400);
+    if (ghost.get(LedSpriteProperty.X) < hero.get(LedSpriteProperty.X)) {
+        ghost.change(LedSpriteProperty.X, 1);
+    }
+    else if (ghost.get(LedSpriteProperty.X) < hero.get(LedSpriteProperty.X)) {
+        ghost.change(LedSpriteProperty.X,  -1 );
+    }
+    else if (ghost.get(LedSpriteProperty.Y) < hero.get(LedSpriteProperty.Y)) {
+        ghost.change(LedSpriteProperty.Y, 1);
+    }
+    else if (ghost.get(LedSpriteProperty.Y) > hero.get(LedSpriteProperty.Y)) {
+        ghost.change(LedSpriteProperty.Y,  -1 );
+    }
+    if (input.acceleration(Dimension.X) > 200) {
+        hero.change(LedSpriteProperty.X, 1);
+    }
+    else if (input.acceleration(Dimension.X) <  -200 ) {
+        hero.change(LedSpriteProperty.X,  -1 );
+    }
+    if (input.acceleration(Dimension.Y) > 200) {
+        hero.change(LedSpriteProperty.Y, 1);
+    }
+    else if (input.acceleration(Dimension.Y) >  -200 ) {
+        hero.change(LedSpriteProperty.Y,  -1 );
+    }
+}
+```
 
 Let's setup the logic for the food. If hero  is `touching` "food", increase the score of the game by 1 and `set` ``x`` -direction of food randomly randomly from 0 to 4 and `set` ``y``-direction of food randomly from 0 to 4.
 
-![](/static/mb/blocks/lessons/hero-8.jpg)
+```blocks
+let hero = game.createSprite(2, 2);
+let food = game.createSprite(4, 4);
+let ghost = game.createSprite(0, 0);
+ghost.change(LedSpriteProperty.Blink, 100);
+food = led.brightness() == 8;
+while (true) {
+    basic.pause(400);
+    if (ghost.get(LedSpriteProperty.X) < hero.get(LedSpriteProperty.X)) {
+        ghost.change(LedSpriteProperty.X, 1);
+    }
+    else if (ghost.get(LedSpriteProperty.X) < hero.get(LedSpriteProperty.X)) {
+        ghost.change(LedSpriteProperty.X,  -1 );
+    }
+    else if (ghost.get(LedSpriteProperty.Y) < hero.get(LedSpriteProperty.Y)) {
+        ghost.change(LedSpriteProperty.Y, 1);
+    }
+    else if (ghost.get(LedSpriteProperty.Y) > hero.get(LedSpriteProperty.Y)) {
+        ghost.change(LedSpriteProperty.Y,  -1 );
+    }
+    if (input.acceleration(Dimension.X) > 200) {
+        hero.change(LedSpriteProperty.X, 1);
+    }
+    else if (input.acceleration(Dimension.X) <  -200 ) {
+        hero.change(LedSpriteProperty.X,  -1 );
+    }
+    if (input.acceleration(Dimension.Y) > 200) {
+        hero.change(LedSpriteProperty.Y, 1);
+    }
+    else if (input.acceleration(Dimension.Y) >  -200 ) {
+        hero.change(LedSpriteProperty.Y,  -1 );
+    }
+    if (hero.isTouching(food)) {
+        game.addScore(1);
+        food.set(LedSpriteProperty.X, Math.random(5));
+        food.set(LedSpriteProperty.Y, Math.random(5));
+    }
 
-**Do not disconnect the blocks from the conditional statements. We are focusing on this section of the code and are not showing the entire code**
+}
 
-Let's setup the logic for the food and the ghost to be in different quadrants.
 
-![](/static/mb/blocks/lessons/hero-9.jpg)
+```
 
-**Do not disconnect the blocks for the conditional statements. We are focusing on this section of the code and are not showing the entire code**
 
-The game over component is now upon the game. If the hero is `touching` the ghost, let's display `game over`
 
-![](/static/mb/blocks/lessons/hero-10.jpg)
+Let's setup the logic for the food and the ghost to be in different quadrants. Finally, the game over component is now upon the game. If the hero is `touching` the ghost, let's display `game over`
 
-**Do not disconnect the conditional statements blocks from the remaining blocks. We are focusing on this section of the code and are not showing the entire code**
+```blocks
 
-The game can also use the buttons. Let's create a `while` loop for button A is pressed. If button A is pressed, the micro:bit will display the word Hero. Let's use a `while` loop for button B is pressed. If button B is pressed, the micro:bit will display image of the hero.
+let hero = game.createSprite(2, 2);
+let food = game.createSprite(4, 4);
+let ghost = game.createSprite(0, 0);
+let ghost.change(LedSpriteProperty.Blink, 100);
+food = led.brightness() == 8;
+while (true) {
+    basic.pause(400);
+    if (ghost.get(LedSpriteProperty.X) < hero.get(LedSpriteProperty.X)) {
+        ghost.change(LedSpriteProperty.X, 1);
+    }
+    else if (ghost.get(LedSpriteProperty.X) < hero.get(LedSpriteProperty.X)) {
+        ghost.change(LedSpriteProperty.X,  -1 );
+    }
+    else if (ghost.get(LedSpriteProperty.Y) < hero.get(LedSpriteProperty.Y)) {
+        ghost.change(LedSpriteProperty.Y, 1);
+    }
+    else if (ghost.get(LedSpriteProperty.Y) > hero.get(LedSpriteProperty.Y)) {
+        ghost.change(LedSpriteProperty.Y,  -1 );
+    }
+    if (input.acceleration(Dimension.X) > 200) {
+        hero.change(LedSpriteProperty.X, 1);
+    }
+    else if (input.acceleration(Dimension.X) <  -200 ) {
+        hero.change(LedSpriteProperty.X,  -1 );
+    }
+    if (input.acceleration(Dimension.Y) > 200) {
+        hero.change(LedSpriteProperty.Y, 1);
+    }
+    else if (input.acceleration(Dimension.Y) >  -200 ) {
+        hero.change(LedSpriteProperty.Y,  -1 );
+    }
+    if (hero.isTouching(food)) {
+        game.addScore(1);
+        food.set(LedSpriteProperty.X, Math.random(5));
+        food.set(LedSpriteProperty.Y, Math.random(5));
+        if (food.get(LedSpriteProperty.X) < 2 && food.get(LedSpriteProperty.Y) < 2) {
+            ghost.set(LedSpriteProperty.X, 4);
+            ghost.set(LedSpriteProperty.Y, 4);
+        }
+        else if (food.get(LedSpriteProperty.X) > 2 && food.get(LedSpriteProperty.Y) < 2) {
+            ghost.set(LedSpriteProperty.X, 0);
+            ghost.set(LedSpriteProperty.Y, 4);
+        }
+        else if (food.get(LedSpriteProperty.X) < 2 && food.get(LedSpriteProperty.Y) > 2) {
+            ghost.set(LedSpriteProperty.X, 4);
+            ghost.set(LedSpriteProperty.Y, 0);
+        }
+        else {
+            ghost.set(LedSpriteProperty.X, 0);
+            ghost.set(LedSpriteProperty.Y, 0);
+        }
+    }
+    if (hero.isTouching(ghost)) {
+        game.gameOver();
+    }
 
-![](/static/mb/blocks/lessons/hero-11.jpg)
+}
+0.set(LedSpriteProperty.X, 4);
+
+
+```
 
 ### ~avatar avatar
 
-You can review the final code for [hero](/microbit/numraj)
+Congratulations! You have a homemade hero game based on the classic version of PacMan
 
 ### ~
 

docs/lessons/light-beatbox.md

@@ -1,6 +1,6 @@
 # light beatbox 
 
-display beautiful images on the BBC micro:bit #var #pause #docs
+display beautiful images on the BBC micro:bit.
 
 ## Topic
 

docs/lessons/looper.md

@@ -1,6 +1,6 @@
 # looper blocks lesson
 
-Learn to control blinking LEDs. #LED #screen  #for #docs
+Learn to control blinking LEDs.
 
 ### @video td/videos/looper-0
 
@@ -26,10 +26,8 @@ Learn how to control a blinking LED. We will be learning how to create a blinkin
 
 ## Documentation
 
-```docs
-for (let i = 0; i < 5; i++) {
-
-}
+```cards
+for (let i = 0; i < 5; i++) {}
 basic.showNumber(0)
 basic.pause(100)
 

docs/lessons/looper/quiz-answers.md

@@ -1,6 +1,6 @@
 # looper quiz answers
 
-Learn how to create a series of numbers with a for loop. #LED #screen #plot #docs
+Learn how to create a series of numbers with a for loop.
 
 This is the answer key for the [looper quiz](/microbit/lessons/looper/quiz).
 

docs/lessons/looper/quiz.md

@@ -1,6 +1,6 @@
 # looper quiz
 
-Learn how to create a series of numbers with a for loop. #LED #screen #plot #docs
+Learn how to create a series of numbers with a for loop.
 
 ## Name
 

docs/lessons/love-meter.md

@@ -1,6 +1,6 @@
 # love meter blocks lesson
 
-create a love meter with the BBC micro:bit #pin #pressed #string #if #var #pause #show #docs
+create a love meter with the BBC micro:bit.
 
 ### @video td/videos/love-meter-0
 
@@ -22,19 +22,11 @@ Learn how to use the **pin pressed**, `on pin pressed` to run code when the user
 
 ## Documentation
 
-```docs
-if (true) {
-
-}
-
-input.onPinPressed(TouchPin.P0, () => {
-
-})
+```cards
+if (true) {}
+input.onPinPressed(TouchPin.P0, () => {})
 let x = 0
 Math.random(3)
 basic.showNumber(0)
 basic.pause(100)
-
-
-
 ```

docs/lessons/lucky-7.md

@@ -1,6 +1,6 @@
 # lucky 7 blocks lesson
 
-show a number on the LED screen #show #number #docs
+show a number on the LED screen.
 
 ### @video td/videos/lucky-7-0
 

docs/lessons/magic-8.md

@@ -1,6 +1,6 @@
 # magic 8 lesson
 
-a fortune teller game with the BBC micro:bit #string #shake #clear-screen #if #string #number #var #docs
+a fortune teller game with the BBC micro:bit.
 
 ## Topic
 
@@ -19,14 +19,10 @@ Learn how to creating **conditionals**, `if condition do` to conditionally run c
 
 ## Documentation
 
-```docs
-if (true) {
-
-}
+```cards
+if (true) {}
 Math.random(3)
-input.onGesture(Gesture.Shake, () => {
-
-})
+input.onGesture(Gesture.Shake, () => {})
 basic.showNumber(7)
 basic.clearScreen()
 basic.showString("Hello!")

docs/lessons/magic-8/quiz-answers.md

@@ -1,6 +1,6 @@
 # magic 8 quiz answers
 
-create a magic 8 ball on the BBC micro:bit #math #random #docs
+create a magic 8 ball on the BBC micro:bit.
 
 ## Name
 

docs/lessons/magic-8/quiz.md

@@ -1,6 +1,6 @@
 # magic 8 quiz 
 
-create a magic 8 ball on the BBC micro:bit #math #random #docs
+create a magic 8 ball on the BBC micro:bit.
 
 ## Name
 

docs/lessons/magic-logo.md

@@ -1,6 +1,6 @@
 # magic logo lesson
 
-show an image that points up when the logo is up #logo #point #docs
+show an image that points up when the logo is up.
 
 ### @video td/videos/magic-logo-0
 
@@ -20,13 +20,9 @@ On Logo Up
 Learn how to plot image **on logo up**, `on logo up` to run code when the micro:bit screen is facing up and vertically orientated. We will be learning how to plot an image with the logo up, basic show LEDs, and logo down.
 
 ## Documentation
-```docs
-input.onLogoUp(() => {
-
-})
-input.onLogoDown(() => {
-    
-})
+```cards
+input.onLogoUp(() => {})
+input.onLogoDown(() => {})
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -34,8 +30,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
-
 ```
 
 ## Objectives

docs/lessons/magic-logo/quiz-answers.md

@@ -1,6 +1,6 @@
 # magic logo quiz answers
 
-show an image that points up when the logo is up #logo #show #create #docs
+show an image that points up when the logo is up.
 
 ## Name
 

docs/lessons/magic-logo/quiz.md

@@ -1,6 +1,6 @@
 # magic logo quiz
 
-show an image that points up when the logo is up #logo #show #create #docs
+show an image that points up when the logo is up.
 
 ## Name
 

docs/lessons/night-light.md

@@ -1,6 +1,6 @@
 # night light lesson
 
-change the brightness of the BBC micro:bit #brightness #plot #docs
+change the brightness of the BBC micro:bit.
 
 ### @video td/videos/night-light-0
 
@@ -21,11 +21,9 @@ Learn how to **set brightness** of an image `set brightness` to set the brightne
 
 ## Documentation
 
-```docs
+```cards
 led.setBrightness(255)
-input.onButtonPressed(Button.A, () => {
-
-})
+input.onButtonPressed(Button.A, () => {})
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -33,7 +31,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
 ```
 
 ## Objectives

docs/lessons/night-light/quiz-answers.md

@@ -1,6 +1,6 @@
 # night light quiz answers
 
-Answers to the night light quiz. #LED #image #brightness #fade #docs
+Answers to the night light quiz.
 
 This is the answer key for the [night light quiz](/microbit/lessons/night-light/quiz).
 

docs/lessons/night-light/quiz.md

@@ -1,6 +1,6 @@
 # night light quiz
 
-change the brightness of the BBC micro:bit #LED #image #brightness #fade #docs
+change the brightness of the BBC micro:bit.
 
 ## Name
 

docs/lessons/offset-image/quiz-answers.md

@@ -1,6 +1,6 @@
 # offset image quiz answers
 
-shift an image horizontally across the display with offset #offset #screen  #variables #docs
+shift an image horizontally across the display with offset.
 
 This is the answer key for the [offset image quiz](/microbit/lessons/offset-image/quiz).
 

docs/lessons/offset-image/quiz.md

@@ -1,6 +1,6 @@
 # offset image quiz
 
-shift an image horizontally across the display with offset #offset #screen  #variables #docs
+shift an image horizontally across the display with offset.
 
 ## Name
 

docs/lessons/pogo.md

@@ -1,6 +1,6 @@
 # pogo lesson
 
-create a game that relies on precise instincts and timing reflexes #if #  #function #data #forever #var #button #if #assignment #pause #string  #number #docs
+create a game that relies on precise instincts and timing reflexes #if #.
 
 ## Topic
 
@@ -15,14 +15,13 @@ Running Time
 Learn how to use running time. We will be learning how to create a pogo game using variables, forever loop, conditionals, on button pressed, as well as simple commands, such as show LEDs and clear screen.
 
 ## Documentation
-```docs
+```cards
 let jumps = 0
 let acc = input.acceleration(Dimension.Y)
-basic.showNumber(jumps)
-basic.showNumber(radio.receiveNumber())
+basic.showNumber(0)
+radio.receiveNumber()
 led.stopAnimation()
-jumps = jumps + 1;
-radio.sendNumber(jumps)
+radio.sendNumber(0)
 basic.forever(() => { })
 basic.showLeds(`
     . . . . .
@@ -32,11 +31,8 @@ basic.showLeds(`
     . # # # .
     `)
 basic.clearScreen()
-if (acc > 2000) {
-
-}
+if (true) {}
 radio.onDataReceived(() => { })
-
 ```
 ## Objectives
 

docs/lessons/prank-wifi.md

@@ -1,9 +1,9 @@
 # prank wifi lesson
 
-create a fake wifi app to trick your friends #abs #acceleration #if #math #plot #image #functions #var #docs
+create a fake wifi app to trick your friends.
 
 create a fake wifi app to trick your friends
 
 * [activity](/microbit/lessons/prank-wifi/activity)
 * [quiz](/microbit/lessons/prank-wifi/quiz)
-
+* [quiz answers](/microbit/lessons/prank-wifi/quiz-answers)

docs/lessons/prank-wifi/activity.md

@@ -130,7 +130,7 @@ basic.forever(() => {
 . . # # #
 . # # # #
 # # # # #
-`) // ***
+`) 
     }
 })
 ```

docs/lessons/prank-wifi/quiz-answers.md

@@ -1,6 +1,6 @@
 # prank wifi quiz answers
 
-create a fake wifi app to trick your friends #string #forever #abs #var #plot #image #if #math #abs #acceleration #docs
+create a fake wifi app to trick your friends.
 
 ## Name
 
@@ -15,9 +15,9 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
 <br/>
 
 ```blocks
-let xAccel = math.abs(input.acceleration("x"))
-let yAccel = math.abs(input.acceleration("y"))
-let zAccel = math.abs(input.acceleration("z"))
+let xAccel = Math.abs(input.acceleration(Dimension.X))
+let yAccel = Math.abs(input.acceleration(Dimension.Y))
+let zAccel = Math.abs(input.acceleration(Dimension.Z))
 ```
 
 <br/>
@@ -29,6 +29,9 @@ let zAccel = math.abs(input.acceleration("z"))
 <br/>
 
 ```blocks
+let xAccel = Math.abs(input.acceleration(Dimension.X))
+let yAccel = Math.abs(input.acceleration(Dimension.Y))
+let zAccel = Math.abs(input.acceleration(Dimension.Z))
 let sum = xAccel + yAccel + zAccel
 ```
 
@@ -39,8 +42,12 @@ let sum = xAccel + yAccel + zAccel
 <br/>
 
 ```blocks
+let xAccel = Math.abs(input.acceleration(Dimension.X))
+let yAccel = Math.abs(input.acceleration(Dimension.Y))
+let zAccel = Math.abs(input.acceleration(Dimension.Z))
+let sum = xAccel + yAccel + zAccel
 if (sum < 1400) {
-    basic.showleds(`
+    basic.showLeds(`
 . . . . .
 . . . . .
 . . # . .
@@ -59,8 +66,12 @@ if (sum < 1400) {
 <br/>
 
 ```blocks
+let xAccel = Math.abs(input.acceleration(Dimension.X))
+let yAccel = Math.abs(input.acceleration(Dimension.Y))
+let zAccel = Math.abs(input.acceleration(Dimension.Z))
+let sum = xAccel + yAccel + zAccel
 if (sum >= 1400 && sum < 1680) {
-    basic.showleds(`
+    basic.showLeds(`
 . . . . .
 . . . # .
 . . # # .
@@ -70,7 +81,7 @@ if (sum >= 1400 && sum < 1680) {
 }
 ```
 
-## 5. Write the 'if statement' needed to display this specific plot image on the device
+## 5. Write the code to display this specific image on the device
 
 ![](/static/mb/lessons/prank-wifi-0.png)
 
@@ -78,9 +89,13 @@ if (sum >= 1400 && sum < 1680) {
 
 <br/>
 
-```
+```blocks
+let xAccel = Math.abs(input.acceleration(Dimension.X))
+let yAccel = Math.abs(input.acceleration(Dimension.Y))
+let zAccel = Math.abs(input.acceleration(Dimension.Z))
+let sum = xAccel + yAccel + zAccel
 if (sum >= 1680) {
-    basic.showleds(`
+    basic.showLeds(`
 . . . . .
 . . . . .
 . . . . .

docs/lessons/prank-wifi/quiz.md

@@ -1,12 +1,12 @@
 # prank wifi quiz
 
-create a fake wifi app to trick your friends #string #forever #abs #var #plot #image #if #math #abs #acceleration #docs
+create a fake wifi app to trick your friends.
 
 ## Name
 
 ## Directions
 
-Use this activity document to guide your work in the [prank WiFi tutorial](/microbit/lessons/prank-wifi/tutorial)
+Use this activity document to guide your work in the [prank WiFi tutorial](/microbit/lessons/prank-wifi/activity)
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 

docs/lessons/rock-paper-scissors.md

@@ -1,6 +1,6 @@
 # rock paper scissors lesson
 
-a game against the BBC micro:bit #var #image #button #string #number #docs
+a game against the BBC micro:bit.
 
 ### @video td/videos/rock-paper-scissors-0
 
@@ -23,10 +23,8 @@ Learn how to create a **local variable**, `var t :=time` where you can store dat
 
 ## Documentation
 
-```docs
-input.onGesture(Gesture.Shake, () => {
-
-})
+```cards
+input.onGesture(Gesture.Shake, () => {})
 Math.random(3)
 let x = 0
 basic.showLeds(`

docs/lessons/rock-paper-scissors/quiz.md

@@ -1,6 +1,6 @@
 # rock paper scissors quiz
 
-shift an image horizontally across the display with offset #offset #screen  #variables #docs
+shift an image horizontally across the display with offset.
 
 ## Name
 

docs/lessons/rotation-animation.md

@@ -1,6 +1,6 @@
 # rotation animation block lesson
 
-Learn how to create images with a global variable and while loop. #LED #screen  #plot #docs
+Learn how to create images with a global variable and while loop.
 
 ## Topic
 
@@ -19,11 +19,9 @@ Learn how to create images that look like a rotating animation by using a while
 
 ## Documentation
 
-```docs
+```cards
 let x = 0
-input.onButtonPressed(Button.A, () => {
-
-})
+input.onButtonPressed(Button.A, () => {})
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -32,10 +30,8 @@ basic.showLeds(`
     . . . . .
     `)
 basic.pause(100)
-while (true) {
-
-    basic.pause(20)
-}
+while (true) {}
+basic.pause(20)
 ```
 
 ## Objectives

docs/lessons/rotation-animation/quiz-answers.md

@@ -1,6 +1,6 @@
 # rotation animation quiz answers
 
-Learn how to create a rotating image with a while loop. #image #loop  #while #docs
+Learn how to create a rotating image with a while loop.
 
 This is the answer key for the [rotation animation quiz](/microbit/lessons/rotation-animation/quiz).
 

docs/lessons/rotation-animation/quiz.md

@@ -1,6 +1,6 @@
 # rotation animation quiz
 
-Learn how to create a rotating image with a while loop. #image #loop  #while #docs
+Learn how to create a rotating image with a while loop.
 
 ## Name
 

docs/lessons/screen-wipe.md

@@ -1,6 +1,6 @@
 # screen wipe blocks lesson
 
-clear the screen by pressing button "A" #button #clear #docs
+clear the screen by pressing button "A".
 
 ### @video td/videos/screen-wipe-0
 
@@ -23,7 +23,7 @@ Learn how to **clear screen**, `clear screen` to turn off all the LED lights on
 
 ## Documentation
 
-```docs
+```cards
 basic.clearScreen()
 basic.showLeds(`
     . . . . .
@@ -32,10 +32,7 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-input.onButtonPressed(Button.A, () => {
-    
-})
-
+input.onButtonPressed(Button.A, () => {})
 ```
 
 ## Objectives

docs/lessons/smiley.md

@@ -24,10 +24,8 @@ Learn how to **show LEDs** to turn on a LED light pattern on the LED screen. We
 * **show LEDs** : [read more...](/microbit/reference/basic/show-leds)
 * **on button pressed** : [read more...](/microbit/reference/input/on-button-pressed)
 
-```docs
-input.onButtonPressed(Button.A, () => {
-
-})
+```cards
+input.onButtonPressed(Button.A, () => {})
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -35,7 +33,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
 ```
 
 ## Objectives

docs/lessons/snowflake-fall.md

@@ -1,6 +1,6 @@
 # snowflake fall blocks lesson
 
-design a blinking rectangle animation #animation #loop #forever #docs
+design a blinking rectangle animation.
 
 ### @video td/videos/snowflake-fall-0
 
@@ -25,7 +25,7 @@ Learn how to show LEDs with a, `pause` to pause program execution for a specifie
 * **pause** : [read more...](/microbit/reference/basic/pause)
 * **forever** : [read more...](/microbit/reference/basic/forever)
 
-```docs
+```cards
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -34,8 +34,5 @@ basic.showLeds(`
     . . . . .
     `)
 basic.pause(100)
-basic.forever(() => {
-    
-})
-
+basic.forever(() => {})
 ```

docs/lessons/snowflake-fall/activity.md

@@ -1,6 +1,6 @@
 # snowflake fall blocks activity
 
-design a blinking rectangle animation. #docs #tutorials #stepByStep
+design a blinking rectangle animation.
 
 ### ~avatar avatar
 

docs/lessons/speed-button.md

@@ -1,6 +1,6 @@
 # speed button lesson
 
-code a speed game by declaring Booleans on the BBC micro:bit #if #string #var #data #docs
+code a speed game by declaring Booleans on the BBC micro:bit.
 
 ### @video td/videos/speed-button-3
 

docs/lessons/speed-button/quiz-answers.md

@@ -1,6 +1,6 @@
 # speed button quiz answers
 
-counter that keeps track of how many times button "A" has been pressed #LED #screen #variables #docs #input
+counter that keeps track of how many times button "A" has been pressed.
 
 This is the answer key for the [speed button quiz](/microbit/lessons/speed-button/quiz).
 
@@ -37,7 +37,7 @@ After two button presses, **count** will be equal to 2.
 ## 5. If the rectangle below represents the BBC micro:bit, shade the areas that will be displayed after five button presses on Button A. Explain why that particular area is shaded.
 
 ```blocks
-count_ = 0
+let count_ = 0
 input.onButtonPressed(Button.A, () => {
     count_ = count_ + 1
     basic.showNumber(count_, 100)

docs/lessons/speed-button/quiz.md

@@ -1,12 +1,12 @@
 # speed button quiz 
 
-counter that keeps track of how many times button "A" has been pressed #LED #screen #variables #docs #input
+counter that keeps track of how many times button "A" has been pressed.
 
 ## Name
 
 ## Directions
 
-Use this activity document to guide your work in the [speed button tutorial](/microbit/lessons/speed-button/tutorial).
+Use this activity document to guide your work in the [speed button tutorial](/microbit/lessons/speed-button/activity).
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 
@@ -37,7 +37,7 @@ input.onButtonPressed(Button.A, () => {
 ## 4. Draw which LED is ON after running this code and pressing Button A five times. Explain why you chose to draw that number.
 
 ```blocks
-count_ = 0
+let count_ = 0
 input.onButtonPressed(Button.A, () => {
     count_ = count_ + 1
     basic.showNumber(count_, 100)

docs/lessons/spinner.md

@@ -1,6 +1,6 @@
 # spinner lesson
 
-a spin the BBC micro:bit game with the input on shake #button #pressed #math #random #var #string #if #docs
+a spin the BBC micro:bit game with the input on shake.
 
 ### @video td/videos/spinner-0
 
@@ -22,14 +22,10 @@ Learn how to use an if statement to run code run code depending on whether a con
 ## Documentation
 
 
-```docs
-if (true) {
-
-}
+```cards
+if (true) {}
 let x = 0
-input.onGesture(Gesture.Shake, () => {
-
-})
+input.onGesture(Gesture.Shake, () => {})
 Math.random(3)
 basic.showLeds(`
     . . . . .

docs/lessons/spinner/quiz-answers.md

@@ -1,6 +1,6 @@
 # spinner quiz answers
 
-a spin the BBC micro:bit game with the input on shake #math #random #docs #shake
+a spin the BBC micro:bit game with the input on shake.
 
 ## Name
 

docs/lessons/spinner/quiz.md

@@ -1,6 +1,6 @@
 # spinner quiz 
 
-a spin the BBC micro:bit game with the input on shake #math #random #docs #shake
+a spin the BBC micro:bit game with the input on shake.
 
 ## Name
 

docs/lessons/stem.md

@@ -1,6 +1,6 @@
 # Block Editor STEM Lessons
 
-Overview of Blocks lessons for the BBC micro:bit. #docs #contents
+Overview of Blocks lessons for the BBC micro:bit.
 
 ### @short Lessons
 

docs/lessons/strobe-light.md

@@ -1,6 +1,6 @@
 # strobe light lesson
 
-Learn how to create a blinking LED script. #LED #screen  #plot #docs
+Learn how to create a blinking LED script.
 
 ### @video td/videos/strobe-light-0
 
@@ -17,14 +17,11 @@ For Loop
 
 ## Documentation
 
-```docs
+```cards
 led.plot(0, 0)
 led.unplot(0, 0)
-for (let i = 0; i < 5; i++) {
-
-}
+for (let i = 0; i < 5; i++) {}
 basic.pause(100)
-
 ```
 
 ## Objectives

docs/lessons/strobe-light/quiz-answers.md

@@ -1,6 +1,6 @@
 # strobe light quiz answers
 
-Learn how to create a blinking images with a for loop. #LED #screen #plot #docs
+Learn how to create a blinking images with a for loop.
 
 This is the answer key for the [strobe light quiz](/microbit/lessons/strobe-light/quiz).
 

docs/lessons/strobe-light/quiz.md

@@ -1,6 +1,6 @@
 # strobe light quiz
 
-Learn how to create a blinking LED script with a for loop. #LED #screen #plot #docs
+Learn how to create a blinking LED script with a for loop.
 
 ## Name
 

docs/lessons/teach.md

@@ -1,6 +1,6 @@
 # Teach Blocks
 
-Overview of lesson instructions for the BBC micro:bit. #docs #contents
+Overview of lesson instructions for the BBC micro:bit.
 
 ### @short Teach
 

docs/lessons/telegraph.md

@@ -1,6 +1,6 @@
 # telegraph lesson
 
-display beautiful images on the BBC micro:bit #var #pause #docs
+display beautiful images on the BBC micro:bit.
 
 ## Topic
 

docs/lessons/telegraph/activity.md

@@ -1,6 +1,6 @@
 # telegraph activity 
 
-Build a telgraph #microbit #docs
+Build a telgraph.
 
 # micro:bit telegraph
 

docs/lessons/telegraph/challenges.md

@@ -1,6 +1,6 @@
 # telegraph activity 
 
-Build a telgraph #microbit #docs
+Build a telgraph.
 
 # micro:bit telegraph
 

docs/lessons/temperature.md

@@ -1,6 +1,6 @@
 # temperature blocks lesson
 
-measure the temperature on the BBC micro:bit #temp #var #docs
+measure the temperature on the BBC micro:bit.
 
 ## Topic
 
@@ -17,15 +17,12 @@ Learn how to get the ambient temperature (degree Celsius °C). The temperature i
 
 ## Documentation
 
-```docs
+```cards
 input.temperature()
 let x = 0
 basic.showNumber(7)
 basic.showString("Hello!")
-input.onGesture(Gesture.Shake, () => {
-    
-})
-
+input.onGesture(Gesture.Shake, () => {})
 ```
 
 ## Objectives

docs/lessons/the-watch.md

@@ -1,6 +1,6 @@
 # the watch lesson
 
-display beautiful images on the BBC micro:bit #var #pause #docs
+display beautiful images on the BBC micro:bit.
 
 ![](/static/mb/lessons/the-watch-0.png)
 

docs/lessons/the-watch/activity.md

@@ -150,9 +150,11 @@ Trim any leftover fabric, threads or tape.
 
 Your watch is ready!
 
-### Step 22
+### ~avatar avatar
 
-Connect your micro:bit to your computer using your USB cable and upload the [rock paper scissors](/microbit/rrwupw) script on it. Shake your watch to play against... the micro:bit!
+Excellent, you're ready to continue with the [challenges](/microbit/lessons/rock-paper-scissors/activity)!
+
+### ~
 
 ### Acknowledgements
 

docs/lessons/truth-or-dare.md

@@ -1,6 +1,6 @@
 # truth or dare lesson
 
-create a love meter with the BBC micro:bit #button #pressed #math #random #var #string #if #docs
+create a love meter with the BBC micro:bit.
 
 ### @video td/videos/truth-or-dare-0
 
@@ -21,7 +21,7 @@ Learn how to use an if statement to run code run code depending on whether a con
 
 ## Documentation
 
-```docs
+```cards
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -29,16 +29,11 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-input.onButtonPressed(Button.A, () => {
-
-})
+input.onButtonPressed(Button.A, () => {})
 let x = 0
 Math.random(3)
-if (true) {
-
-}
+if (true) {}
 basic.showString("Hello!")
-
 ```
 
 ## Objectives

docs/lessons/truth-or-dare/quiz-answers.md

@@ -1,6 +1,6 @@
 # truth or dare quiz answers
 
-a multi-player game that forces each player to reveal a secret or something funny #math #random #docs #shake
+a multi-player game that forces each player to reveal a secret or something funny.
 
 This is the answer key for the [truth or dare quiz](/microbit/lessons/truth-or-dare/quiz).
 

docs/lessons/truth-or-dare/quiz.md

@@ -1,6 +1,6 @@
 # truth or dare quiz
 
-a multi-player game that forces each player to reveal a secret or something funny #math #random #docs #shake
+a multi-player game that forces each player to reveal a secret or something funny.
 
 ## Name
 

docs/lessons/zoomer.md

@@ -1,6 +1,6 @@
 # zoomer blocks lesson
 
-measure the acceleration on the micro:bit in the "z" direction #acceleration #var #docs #if #show
+measure the acceleration on the micro:bit in the "z" direction.
 
 ### @video td/videos/zoomer-0
 
@@ -21,7 +21,7 @@ Learn how to get the **acceleration**, `acceleration` in one of three specified
 
 ## Documentation
 
-```docs
+```cards
 basic.forever(() => {
 })
 let x = 0

docs/lessons/zoomer/quiz-answers.md

@@ -1,6 +1,6 @@
 # zoomer quiz answers
 
-Measure the acceleration on the micro:bit in the "z" direction #LED #number #math #acceleration #docs
+Measure the acceleration on the micro:bit in the "z" direction.
 
 This is the answer key for the [zoomer quiz](/microbit/lessons/zoomer/quiz).
 

docs/lessons/zoomer/quiz.md

@@ -1,6 +1,6 @@
 # zoomer quiz
 
-Measure the acceleration on the micro:bit in the "z" direction #LED #number #math #acceleration #docs
+Measure the acceleration on the micro:bit in the "z" direction.
 
 ## Name
 

docs/reference.md

@@ -1,460 +1,17 @@
 # Reference
 
-### @section full
-
-### ~column 
-
-### Basic
-
-[show number](/microbit/reference/basic/show-number)
-
-~~~~block
-basic.showNumber(2)
-~~~~
-
-[show string](/microbit/reference/basic/show-string)
-
-~~~~block
-basic.showString('Hello!')
-~~~~
-
-[show LEDs](/microbit/reference/basic/show-leds)
-
-~~~~block
-basic.showLeds(`. . . . . 
-. # . # . 
-. . . . . 
-# . . . # 
-. # # # .`)
-~~~~
-
-[clear screen](/microbit/reference/basic/clear-screen)
-
-~~~~block
-basic.clearScreen()
-~~~~
-
-[forever](/microbit/reference/basic/forever)
-
-~~~~block
-basic.forever(() => { })
-~~~~
-
-[pause](/microbit/reference/basic/pause)
-
-```block
-basic.pause(200)
-```
-
-### Input
-
-[on button pressed](/microbit/reference/input/on-button-pressed)
-
-```block
-input.onButtonPressed(Button.A, () => {})
-```
-
-[on pin pressed](/microbit/reference/input/on-pin-pressed)
-
-```block
-input.onPinPressed(TouchPin.P0, () => {})
-```
-
-[on shake](/microbit/reference/input/on-shake)
-
-![](/static/mb/blocks/contents-22.jpg)
-
-[on logo up](/microbit/reference/on-logo-up)
-
-![](/static/mb/on-logo-up-0.jpg)
-
-[on logo down](/microbit/reference/on-logo-down)
-
-![](/static/mb/on-logo-down-0.jpg)
-
-[on screen up](/microbit/reference/on-screen-up)
-
-![](/static/mb/on-screen-up-0.jpg)
-
-[on screen down](/microbit/reference/on-screen-down)
-
-![](/static/mb/on-screen-down-0.jpg)
-
-[button is pressed](/microbit/reference/button-is-pressed)
-
-![](/static/mb/button-is-pressed-0.png)
-
-[compass heading](/microbit/reference/compass-heading)
-
-![](/static/mb/compass-heading-0.png)
-
-[temperature](/microbit/reference/temperature)
-
-![](/static/mb/temperature-0.png)
-
-[acceleration](/microbit/reference/input/acceleration)
-
-![](/static/mb/acceleration-0.png)
-
-[rotation](/microbit/reference/rotation)
-
-![](/static/mb/rotation-0.png)
-
-[magnetic force](/microbit/reference/magnetic-force)
-
-![](/static/mb/magnetic-force-0.png)
-
-[running time](/microbit/reference/running-time)
-
-![](/static/mb/running-time-0.png)
-
-### Loops
-
-[for](/microbit/reference/loops/for)
-
-```block
-for(let i = 0;i<5;i++) {}
-```
-
-[repeat](/microbit/reference/loops/repeat)
-
-![](/static/mb/blocks/contents-0.png)
-
-[while](/microbit/reference/loops/while)
-
-```block
-while(true) {}
-```
-
-[forever](/microbit/reference/basic/forever)
-
-```block
-basic.forever(() => {})
-```
-
-
-
-### ~
-
-### ~column 
-
-### Logic
-
-[if](/microbit/reference/logic/if)
-
-```block
-if(false) {
-}
-```
-
-[Boolean](/microbit/reference/types/boolean) values: *true*; *false*
-
-```block
-true
-false
-```
-
-Boolean binary operators: *and* (conjunction); *or* (disjunction)
-
-```block
-true && false;
-true || false;
-```
-
-Boolean negation operator
-
-```block
-!true
-```
-
-Comparison operators (=, !=, <, >, <=, >=)
-
-```block
-0 == 0;
-1 !- 0;
-0 < 1;
-1 > 0;
-0 <= 1;
-1 >= 0;
-```
-
-### Variables
-
-[Assign](/microbit/reference/variables/assign) (set) a variable's value
-
-```block
+```namespaces
+basic.showString("Hello!");
+input.onButtonPressed(Button.A, () => {});
+for (let i = 0;i<5;++i) {}
+if (true){}
 let x = 0;
-```
-
-Get a variable's value
-
-```block
-let x = 0;
-x;
-```
-
-[Change](/microbit/reference/variables/change-var) a variable's value
-
-```block
-let x = 0;
-x+=1;
-```
-
-### Math
-
-[Numeric](/microbit/reference/types/number) values: 0, 1, 2, ...
-
-```block
-0;
-1;
-2;
-```
-
-Arithmetic binary operation (+, -, *, /)
-
-```block
-0+1;
-0-1;
-1*2;
-3/4;
-```
-
-Absolute value
-
-```block
-Math.abs(-5);
-```
-
-Minimum/maximum of two values
-
-```block
-Math.min(0, 1);
-Math.max(0, 1);
-```
-
-Random value
-
-```block
 Math.random(5);
+led.plot(0,0);
+radio.sendNumber(0);
+music.playTone(music.noteFrequency(Note.C), music.beat(BeatFraction.Whole));
+game.createSprite(2,2);
+pins.digitalReadPin(DigitalPin.P0);
+serial.writeLine("Hello!");
+control.inBackground(() => {});
 ```
-
-### LED
-
-[plot](/microbit/reference/led/plot)
-
-```block
-led.plot(2,2)
-```
-
-[unplot](/microbit/reference/led/unplot)
-
-```block
-led.unplot(2,2)
-```
-
-[point](/microbit/reference/point)
-
-```block
-led.point(2,2)
-```
-
-[brightness](/microbit/reference/brightness)
-
-```block
-led.brightness()
-```
-
-[set brightness](/microbit/reference/set-brightness)
-
-```block
-led.setBrightness(255)
-```
-
-[stop animation](/microbit/reference/stop-animation)
-
-```block
-led.stopAnimation()
-```
-
-[plot bar graph](/microbit/reference/led/plot-bar-graph)
-
-```block
-led.plotBarGraph(0, 1023)
-```
-
-### Game
-
-[create sprite](/microbit/reference/game/create-sprite)
-
-![](/static/mb/create-sprite-0.png)
-
-[move](/microbit/reference/game/move)
-
-![](/static/mb/game-library/move-0.png)
-
-[turn](/microbit/reference/game/turn)
-
-![](/static/mb/game-library/turn-0.png)
-
-[change](/microbit/reference/game/change)
-
-![](/static/mb/change-0.png)
-
-[set](/microbit/reference/game/set)
-
-![](/static/mb/blocks/contents-21.png)
-
-[reports](/microbit/reference/reports)
-
-![](/static/mb/game-library/position-0.png)
-
-[touching](/microbit/reference/touching)
-
-![](/static/mb/game-library/touching-0.png)
-
-[touching edge](/microbit/reference/touching-edge)
-
-![](/static/mb/game-library/touching-edge-0.png)
-
-[if on edge, bounce](/microbit/reference/logic/if-on-edge-bounce)
-
-![](/static/mb/game-library/if-on-edge-bounce-0.png)
-
-[change score by](/microbit/reference/change-score-by)
-
-![](/static/mb/game-library/pic1.png)
-
-[score](/microbit/reference/score)
-
-![](/static/mb/game-library/pic2.png)
-
-[start countdown](/microbit/reference/start-countdown)
-
-![](/static/mb/game-library/pic3.png)
-
-[game over](/microbit/reference/game-over)
-
-![](/static/mb/game-library/pic0.png)
-
-### Music
-
-[play tone](/microbit/reference/play-tone)
-
-![](/static/mb/play-tone-0.jpg)
-
-[ring tone](/microbit/reference/ring-tone)
-
-![](/static/mb/ring-tone-0.jpg)
-
-[rest](/microbit/reference/rest)
-
-![](/static/mb/rest-0.jpg)
-
-[tempo](/microbit/reference/tempo)
-
-![](/static/mb/tempo-0.jpg)
-
-[set tempo](/microbit/reference/set-tempo)
-
-![](/static/mb/change-tempo-0.jpg)
-
-[change tempo](/microbit/reference/music/set-tempo)
-
-![](/static/mb/change-tempo-by-0.jpg)
-
-### Comments
-
-[comment](/microbit/reference/comment)
-
-### Images
-
-[show image](/microbit/reference/show-image)
-
-![](/static/mb/show-image-0.png)
-
-[scroll image](/microbit/reference/scroll-image)
-
-![](/static/mb/scroll-image-0.png)
-
-[create image](/microbit/reference/create-image)
-
-![](/static/mb/create-image-0.png)
-
-
-### ~
-
-### ~column 
-
-### Pins
-
-[digital read pin](/microbit/reference/pins/digital-read-pin)
-
-![](/static/mb/digital-read-pin-0.png)
-
-[digital write pin](/microbit/reference/pins/digital-write-pin)
-
-![](/static/mb/digital-write-pin-0.png)
-
-[analog read pin](/microbit/reference/pins/analog-read-pin)
-
-![](/static/mb/analog-read-pin-0.png)
-
-[analog write pin](/microbit/reference/pins/analog-write-pin)
-
-![](/static/mb/blocks/contents-23.png)
-
-[analog set period](/microbit/reference/pins/analog-set-period)
-
-![](/static/mb/analog-set-period-0.png)
-
-[servo write pin](/microbit/reference/pins/servo-write-pin)
-
-![](/static/mb/servo-write-pin-0.png)
-
-[servo set pulse](/microbit/reference/pins/servo-set-pulse)
-
-![](/static/mb/servo-set-pulse-0.png)
-
-[map](/microbit/reference/map)
-
-![](/static/mb/map-0.png)
-
-
-## Devices
-
-Functions in this category require to be connected to a remote device.
-
-[tell camera to](/microbit/reference/devices/tell-camera-to)
-
-![](/static/mb/tell-camera-to-0.png)
-
-[tell remote control to](/microbit/reference/devices/tell-remote-control-to)
-
-![](/static/mb/tell-remote-control-to-0.png)
-
-[raise alert to](/microbit/reference/devices/raise-alert-to)
-
-![](/static/mb/raise-alert-to-0.png)
-
-[on notified](/microbit/reference/on-notified)
-
-![](/static/mb/on-notified-0.png)
-
-[on gamepad button](/microbit/reference/on-gamepad-button)
-
-![](/static/mb/on-gamepad-button-0.png)
-
-[on notified](/microbit/reference/on-notified)
-
-![](/static/mb/on-notified-0.png)
-
-[signal strength](/microbit/reference/signal-strength)
-
-![](/static/mb/blocks/contents-24.png)
-
-[on signal strength changed](/microbit/reference/on-signal-strength-changed)
-
-![](/static/mb/blocks/contents-25.png)
-
-### ~
-