0.2.29

.gitignore

@@ -7,3 +7,4 @@ tmp/
 *.tgz
 temp/
 *.db
+projects/

.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,6 +1,5 @@
 # Lessons 
 
-Overview of lessons for the BBC micro:bit.
 
 ### @short Lessons
 
@@ -52,17 +51,19 @@ Overview of lessons for the BBC micro:bit.
 ### ~column 
 
 ## Maker
-
 * [The Watch](/microbit/lessons/the-watch), design and create The Watch
 * [Hack your Headphones](/microbit/lessons/hack-your-headphones), create music on the BBC micro:bit by hacking your headphones
 * [Banana Keyboard](/microbit/lessons/banana-keyboard), create music with fruits
 * [Telegraph](/microbit/lessons/telegraph), play the telegraph game between two BBC micro:bits
-* [Ornament Chain](/microbit/lessons/ornament-chain), play the ornament chain game between two BBC micro:bits
+* [Pogo](/microbit/lessons/pogo), create a pogo game to test your jumping abilities
 
 ## Advanced
-
+* [Charting](/microbit/lessons/charting), create a charting app between 2 BBC micro:bits
+* [Prank WiFi](/microbit/lessons/prank-wifi), create fake WiFi to trick your friends
+* [Speed Button](/microbit/lessons/speed-button), code a speed game with running time
+* [Headbands](/microbit/lessons/headbands), create a charades game with a collection of strings that hold the words
 * [Hero](/microbit/lessons/hero), reconstruct the classic arcade game pac man with the BBC micro:bit
-
+* [Catch the Egg](/microbit/lessons/catch-the-egg-game), catch falling eggs in a basket with an acceleration controller
 ### ~
 
 ### @section full

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/activity.md

@@ -4,13 +4,9 @@ a game similar to "Simon Says" with the BBC micro:bit. #docs
 
 ## Before we get started
 
-Complete the following guided tutorial:
+Complete the following guided tutorial. Your code should look like this:
 
-* [tutorial](/microbit/lessons/bop-it/tutorial)
-
-At the end of the tutorial, click `keep editing`. Your code should look like this:
-
-```
+```blocks
 newAction() // ***
 input.onButtonPressed(Button.A, () => {
     if (action == 0) {
@@ -21,27 +17,27 @@ input.onButtonPressed(Button.A, () => {
 input.onLogoDown(() => {
     if (action == 1) {
         game.addScore(1) // ***
-        newAction() // ***
+        newAction() 
     }
-}) // ***
+}) 
 input.onGesture(Gesture.Shake, () => {
     if (action == 2) {
-        game.addScore(1) // ***
-        newAction() // ***
+        game.addScore(1)
+        newAction()
     }
-}) // ***
+}) 
 input.onButtonPressed(Button.B, () => {
     basic.showNumber(game.score(), 150) // ***
     basic.pause(2000) // ***
     newAction() // ***
-}) // ***
+}) 
 ```
 
 ### Challenge 1
 
 Now let's add some more types of instructions for the player to follow. Let's add `PRESS PIN 0`. Change the global variable `action` to `math->random(4)` so that we can add a new **IF** statement that checks if `action=3`. If it does, display instructions to press pin 0.
 
-```
+```blocks
 /**
  * {highlight}
  */

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
 
@@ -10,14 +10,9 @@ Variables
 
 ## Quick Links
 
-* [tutorial](/microbit/lessons/catch-the-egg-game/tutorial)
+* [activity](/microbit/lessons/catch-the-egg-game/activity)
 * [quiz](/microbit/lessons/catch-the-egg-game/quiz)
 * [quiz answers](/microbit/lessons/catch-the-egg-game/quiz-answers)
-* [challenges](/microbit/lessons/catch-the-egg-game/challenges)
-
-## Class
-
-Year 7
 
 ## Prior learning/place of lesson in scheme of work
 
@@ -40,7 +35,7 @@ Learn how to create a catch the egg game game with **plot**, `led->plot` , **unp
 
 ## Objectives
 
-* learn how to create a global variable as a place where you can store data so that you can use it later in your code, accessible across functions and in nested code blocks
+* learn how to create a variable as a place where you can store data so that you can use it later in your code, accessible across functions and in nested code blocks
 * learn how to repeat code in the background forever
 * learn how to turn off a LED light on the LED screen
 * learn how to turn on a LED light on the LED screen
@@ -52,40 +47,3 @@ Learn how to create a catch the egg game game with **plot**, `led->plot` , **unp
 * learn how to return the modulus
 * learn how to show a number of the BBC micro:bit screen
 * learn how to pause your code for the specified number of milliseconds
-
-## Progression Pathways / Computational Thinking Framework
-
-#### Algorithms
-
-* Designs solutions (algorithms) that use repetition and two-way  selection, ie if, then and else.(AL)
-*  Uses logical reasoning to predict  outputs, showing an awareness of inputs (AL)
-* Recognises that different solutions exist for the same problem (AL) (AB)  Understands that iteration is the repetition of a process such as a loop (AL)
-* Represents solutions using a structured notation (AL) (AB)
-
-#### Programming & Development
-
-* Creates programs that implement algorithms to achieve given goals (AL)
-*  Declares and assigns variables(AB)
-* Understands the difference between, and appropriately uses if and if, then and else statements(AL)
-* Uses a variable and relational operators within a loop to govern termination (AL) (GE)
-* Has practical experience of a high-level textual language, including using standard libraries when programming(AB) (AL)
-* Uses a range of operators and expressions e.g. Boolean, and applies them in the context of program control. (AL)
-* Selects the appropriate data types(AL) (AB
-
-Computational Thinking Concept: AB = Abstraction; DE = Decomposition; AL = Algorithmic Thinking; EV = Evaluation; GE = Generalisation
-
-## Activity
-
-* time: 20 min.
-* [tutorial](/microbit/lessons/catch-the-egg-game/tutorial)
-* [quiz](/microbit/lessons/catch-the-egg-game/quiz)
-
-## Extended Activity
-
-* time: 20 min.
-* [challenges](/microbit/lessons/catch-the-egg-game/challenges)
-
-## Homework
-
-* Extended Activity: [challenges](/microbit/lessons/catch-the-egg-game/challenges)
-

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

@@ -4,13 +4,9 @@ Coding challenges for catch the egg game.
 
 ## Before we get started
 
-Complete the following guided tutorial:
+Your starting code should look like this:
 
-* [tutorial](/microbit/lessons/catch-the-egg-game/tutorial)
-
-At the end of the tutorial, click `keep editing`. Your code should look like this:
-
-```
+```blocks
 let basketX = 2
 let eggX = 2
 let eggY = 0
@@ -20,7 +16,7 @@ basic.forever(() => {
     eggY = eggY + 1
     led.plot(eggX, eggY)
     basic.pause(300)
-    let accX = input.acceleration("x")
+    let accX = input.acceleration(Dimension.X)
     basketX = 2 + Math.min(2, Math.max(-2, accX / 200))
     led.plot(basketX, 4)
     if (eggY > 4) {
@@ -35,21 +31,13 @@ basic.forever(() => {
 
 ### Challenge 1
 
-Let's start by adding the **game** library.
-
-### ~
-
-### ~avatar avatar improvised
-
-### Challenge 2
-
 Let's use an **IF** statement to detect if the egg and the basket are lined up.
 
 Now that we know when an egg is caught, we can keep track of the score! We need to use the `add score` function built into the game library to add `1` point for every egg that is caught. However, let's not forget to `remove life` if an egg falls off the display before it's caught!
 
 ### ~
 
-```
+```blocks
 let basketX1 = 2
 let eggX1 = 2
 let eggY1 = 0
@@ -59,8 +47,8 @@ basic.forever(() => {
     eggY1 = eggY1 + 1
     led.plot(eggX1, eggY1)
     basic.pause(300)
-    let accX1 = input.acceleration("x")
-    basketX1 = 2 + Math.min(2, Math.max(-2, accX1 / 200))
+    let accX = input.acceleration(Dimension.X)
+    basketX1 = 2 + Math.min(2, Math.max(-2, accX / 200))
     led.plot(basketX1, 4)
     if (eggY1 > 4) {
         eggY1 = -1
@@ -68,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)
@@ -81,13 +69,13 @@ basic.forever(() => {
 
 ### ~avatar avatar encourage
 
-### Challenge 3
+### Challenge 2
 
 Catching eggs gets easier with practice so let's make the eggs fall faster every 5 catches. We can do this by tracking how long the egg pauses in each position while falling with a global variable called **falling pause**. Let's create this variable and set it to `300` initially. Don't forget to also create a condition that will be true every 5 catches.
 
 ### ~
 
-```
+```blocks
 let basketX2 = 2
 let eggX2 = 2
 let eggY2 = 0
@@ -98,7 +86,7 @@ basic.forever(() => {
     eggY2 = eggY2 + 1
     led.plot(eggX2, eggY2)
     basic.pause(300)
-    let accX2 = input.acceleration("x")
+    let accX2 = input.acceleration(Dimension.X)
     basketX2 = 2 + Math.min(2, Math.max(-2, accX2 / 200))
     led.plot(basketX2, 4)
     if (eggY2 > 4) {
@@ -108,7 +96,7 @@ basic.forever(() => {
     if (eggY2 == 4) {
         if (basketX2 == eggX2) {
             game.addScore(1)
-            if (math.mod(game.score(), 5) == 0) {
+            if (game.score() %5 == 0) {
             }
         } else {
             game.removeLife(1)
@@ -120,13 +108,13 @@ basic.forever(() => {
 
 ### ~avatar avatar surprised
 
-### Challenge 4
+### Challenge 3
 
 ### @video td/videos/catch-the-egg-game-4
 
 Let's make the egg fall faster by decreasing the amount of time it pauses in each position by decreasing **falling pause** by `25` every 5 catches. Now, instead of pausing for 300 milliseconds we can pause for the value of **falling pause**.
 
-```
+```blocks
 let basketX3 = 2
 let eggX3 = 2
 let eggY3 = 0
@@ -137,7 +125,7 @@ basic.forever(() => {
     eggY3 = eggY3 + 1
     led.plot(eggX3, eggY3)
     basic.pause(300)
-    let accX3 = input.acceleration("x")
+    let accX3 = input.acceleration(Dimension.X)
     basketX3 = 2 + Math.min(2, Math.max(-2, accX3 / 200))
     led.plot(basketX3, 4)
     if (eggY3 > 4) {
@@ -147,15 +135,16 @@ basic.forever(() => {
     if (eggY3 == 4) {
         if (basketX3 == eggX3) {
             game.addScore(1)
-            if (math.mod(game.score(), 5) == 0) {
+            if (game.score()% 5 == 0) {
                 fallingPause1 = fallingPause1 - 25 // ***
             }
         } else {
             game.removeLife(1)
         }
     }
-    basic.pause(fallingPause1) // ***
+    basic.pause(fallingPause1) 
 })
+
 ```
 
 Fantastic! Your game is now ready to show off.

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

@@ -22,7 +22,10 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
 
 <br/>
 
-```
+```blocks
+let basketX = 2
+let eggX = 2
+let eggY = 0
 led.plot(eggX, eggY)
 led.plot(basketX, 4)
 ```
@@ -31,28 +34,22 @@ led.plot(basketX, 4)
 
 <br/>
 
-```
+```blocks
+let basketX = 2
+let eggX = 2
+let eggY = 0
 led.unplot(eggX, eggY)
 eggY = eggY + 1
 led.plot(eggX, eggY)
 ```
 
-## 4. Write the code that calculates 'basket x' given the variable 'acc x'.
+## 4. . Write the code that resets the egg after it has fallen past the bottom of the BBC micro:bit.
 
 <br/>
 
-```
-let accX = input.acceleration("x")
-basketX = 2 + Math.min(2, Math.max(-2, accX / 200))
-```
-
-Note: the first line of code in this answer is optional.
-
-## 5. Write the code that resets the egg after it has fallen past the bottom of the BBC micro:bit.
-
-<br/>
-
-```
+```blocks
+let eggX = 2
+let eggY = 0
 if (eggY > 4) {
     eggY = -1
     eggX = Math.random(5)

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

@@ -6,11 +6,11 @@ Programming a game of catch the egg using the accelerometer.
 
 ## Directions
 
-Use this activity document to guide your work in the [catch the egg tutorial](/microbit/lessons/catch-the-egg-game/tutorial)
+Use this activity document to guide your work in the [catch the egg challenges](/microbit/lessons/catch-the-egg-game/activity)
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 
-## 1. Write the data type for the global variables 'basket' and 'egg'.
+## 1. Write the data type for the variables 'basket' and 'egg'.
 
 <br/>
 
@@ -24,11 +24,7 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
 
 <br/>
 
-## 4. Write the code that calculates 'basket x' given the variable 'acc x'.
-
-<br/>
-
-## 5. Write the code that resets the egg after it has fallen past the bottom of the BBC micro:bit.
+## 4. Write the code that resets the egg after it has fallen past the bottom of the BBC micro:bit.
 
 <br/>
 

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
 
@@ -10,9 +10,6 @@ Acceleration
 
 * [activity](/microbit/lessons/charting/activity)
 
-## Class
-
-Year 7
 
 ## Prior learning/place of lesson in scheme of work
 
@@ -20,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
 
@@ -11,9 +11,7 @@ Music
 * [activity](/microbit/lessons/classic-beatbox/activity)
 * [challenges](/microbit/lessons/classic-beatbox/challenges)
 
-## Class
 
-Year 7
 
 ## Prior learning/place of lesson in scheme of work
 
@@ -23,40 +21,3 @@ Learn how to make a beatbox music player using pins P1 and P2. We will be learni
 
 * learn how to code music on the BBC micro:bit
 
-## Progression Pathways / Computational Thinking Framework
-
-#### Algorithms
-
-* Uses diagrams to express solutions.(AB)
-* Represents solutions using a structured notation (AL) (AB)
-
-#### Programming & Development
-
-* Creates programs that implement algorithms to achieve given goals (AL)
-* Selects the appropriate data types(AL) (AB
-
-#### Communication Networks
-
-* Demonstrates responsible use of technologies and online services, and knows a range of ways to report concerns Understands how search engines rank search results (AL)
-
-#### Information Technology
-
-* Collects, organizes, and presents data and information in digital content (AB)
-* Makes appropriate improvements to solutions based on feedback received, and can comment on the success of the solution (EV)
-
-Computational Thinking Concept: AB = Abstraction; DE = Decomposition; AL = Algorithmic Thinking; EV = Evaluation; GE = Generalisation
-
-## Activity
-
-* time: 20 min.
-* [activity](/microbit/lessons/classic-beatbox/activity)
-
-## Extended Activity
-
-* time: 20 min.
-* [challenges](/microbit/lessons/classic-beatbox/challenges)
-
-## Homework
-
-* Extended Activity: [challenges](/microbit/lessons/classic-beatbox/challenges)
-

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
 
@@ -12,7 +12,8 @@ If (Conditionals)
 
 * [activity](/microbit/lessons/compass/activity)
 * [challenges](/microbit/lessons/compass/challenges)
-
+* [quiz](/microbit/lessons/compass/quiz)
+* [quiz answers](/microbit/lessons/compass/quiz-answers)
 
 ## Prior learning/place of lesson in scheme of work
 
@@ -20,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/compass/activity.md

@@ -41,7 +41,7 @@ If `degrees` is less than 135, the micro:bit is mostly pointing East. Display `E
 
 
 ```blocks
- let degrees = null;
+ let degrees = 0;
 basic.forever(() => {
     degrees = input.compassHeading();
     if (degrees < 45) {
@@ -57,7 +57,7 @@ If `degrees` is less than 225, the micro:bit is mostly pointing South. Display `
 
 
 ```blocks
- let degrees = null;
+ let degrees = 0;
 basic.forever(() => {
     degrees = input.compassHeading();
     if (degrees < 45) {
@@ -76,7 +76,7 @@ basic.forever(() => {
 If none of these conditions returned true, then the micro:bit must be pointing West. Display `W` on the micro:bit.
 
 ```blocks
- let degrees = null;
+ let degrees = 0;
 basic.forever(() => {
     degrees = input.compassHeading();
     if (degrees < 45) {

docs/lessons/compass/challenges.md

@@ -7,7 +7,7 @@ Display the direction that the micro:bit is facing using the compass
 Complete the following [guided tutorial](/microbit/lessons/compass/activity), your code should look like this:
 
 ```blocks
- let degrees = null;
+ let degrees = 0;
 basic.forever(() => {
     degrees = input.compassHeading();
     if (degrees < 45) {
@@ -30,7 +30,7 @@ basic.forever(() => {
 Instead of displaying `N` when the BBC micro:bit is pointing North, display a star to indicate the north star.
 
 ```blocks
- let degrees = null;
+ let degrees = 0;
 basic.forever(() => {
     degrees = input.compassHeading();
     if (degrees < 45) {
@@ -61,7 +61,7 @@ basic.forever(() => {
 Instead of displaying just `N`, `W`, `S`, or `E`, display the full word.
 
 ```blocks
- let degrees = null;
+ let degrees = 0;
 basic.forever(() => {
     degrees = input.compassHeading();
     if (degrees < 45) {

docs/lessons/compass/quiz-answers.md

@@ -26,6 +26,7 @@ let degrees = input.compassHeading()
 
 
 ```blocks
+let degrees = input.compassHeading()
 if (degrees < 45) {
     basic.showString("N", 150)
 }
@@ -35,6 +36,7 @@ if (degrees < 45) {
 
 
 ```blocks
+let degrees = input.compassHeading()
 if (degrees < 135) {
     basic.showString("E", 150)
 }
@@ -44,6 +46,7 @@ if (degrees < 135) {
 
 
 ```blocks
+let degrees = input.compassHeading()
 if (degrees < 225) {
     basic.showString("S", 150)
 }

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
 
@@ -12,6 +12,8 @@ Variables
 
 * [activity](/microbit/lessons/counter/activity)
 * [challenges](/microbit/lessons/counter/challenges)
+* [quiz](/microbit/lessons/counter/quiz)
+* [quiz answers](/microbit/lessons/counter/quiz-answers)
 
 ## Prior learning/place of lesson in scheme of work
 
@@ -19,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(`
     . . . . .
     . . . . .
@@ -42,7 +34,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
 ```
 
 * **variable**: [read more...](/microbit/reference/variables/var)

docs/lessons/counter/quiz-answers.md

@@ -23,10 +23,10 @@ We create a **variable**, `count` to keep track of the current count. The number
 ## 3. Draw which LEDs are ON after running this code and pressing button "A" once. Explain you chose to draw that number
 
 ```blocks
-let count_ = 0
+let count = 0
 input.onButtonPressed(Button.A, () => {
-    count_ = count_ + 1
-    basic.showNumber(count, 150)
+    count = count + 1
+    basic.showNumber(count)
 })
 ```
 
@@ -39,10 +39,10 @@ We are only pressing on button pressed once. So the number to display on the mic
 ## 4. Draw which LEDs are ON after running this code and pressing button "A" three times. Explain you chose to draw that number
 
 ```blocks
-count_ = 0
+let count = 0
 input.onButtonPressed(Button.A, () => {
-    count_ = count_ + 1
-    basic.showNumber(count_, 100)
+    count =  + 1
+    basic.showNumber(count)
 })
 ```
 

docs/lessons/counter/quiz.md

@@ -27,10 +27,10 @@ let count = 0
 ## 3. Draw which LEDs are ON after running this code and pressing button "A" once. Explain you chose to draw that number
 
 ```blocks
-let count_ = 0
+let counts = 0
 input.onButtonPressed(Button.A, () => {
-    count_ = count_ + 1
-    basic.showNumber(count_, 100)
+    counts = counts + 1
+    basic.showNumber(counts, 150)
 })
 ```
 
@@ -41,10 +41,10 @@ input.onButtonPressed(Button.A, () => {
 ## 4. Draw which LEDs are ON after running this code and pressing button "A" three times. Explain you chose to draw that number
 
 ```blocks
-count_ = 0
+let counting= 0
 input.onButtonPressed(Button.A, () => {
-    count_ = count_ + 1
-    basic.showNumber(count_, 100)
+    counting = counting + 1
+    basic.showNumber(counting, 100)
 })
 ```
 

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
 
@@ -12,7 +12,8 @@ If (Conditionals)
 
 * [activity](/microbit/lessons/die-roll/activity)
 * [challenges](/microbit/lessons/die-roll/challenges)
-
+* [quiz](/microbit/lessons/die-roll/quiz)
+* [quiz answers](/microbit/lessons/die-roll/quiz-answers)
 
 ## Prior learning/place of lesson in scheme of work
 
@@ -20,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(`
     . . . . .
     . . . . .
@@ -42,10 +33,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
-
-
-
 ```
 
 ## Objectives

docs/lessons/die-roll/quiz-answers.md

@@ -8,7 +8,7 @@ These are the answers to the [die roll quiz](/microbit/lessons/die-roll/quiz).
 
 <br/>
 
-```
+```blocks
 let roll = Math.random(6)
 ```
 
@@ -18,9 +18,10 @@ let roll = Math.random(6)
 
 <br/>
 
-```
+```blocks
+let roll = Math.random(6)
 if (roll == 5) {
-    basic.plotImage(`
+    basic.showLeds(`
 . # . # .
 . . . . .
 . # . # .
@@ -36,9 +37,11 @@ if (roll == 5) {
 
 <br />
 
-```
+```blocks
+
+let roll = Math.random(6)
 if (roll == 5) {
-    basic.plotImage(`
+    basic.showLeds(`
 . # . # .
 . . . . .
 . # . # .
@@ -46,7 +49,7 @@ if (roll == 5) {
 . # . # .
 `)
 } else if (roll == 4) {
-    basic.plotImage(`
+    basic.showLeds(`
 . . . . .
 . # . # .
 . . # . .
@@ -64,9 +67,10 @@ Note: students are only required to write the bottom half of this answer, starti
 
 <br />
 
-```
+```blocks
+let roll = Math.random(6)
 if (roll == 4) {
-    basic.plotImage(`
+    basic.showLeds(`
 . . . . .
 . # . # .
 . . # . .
@@ -74,7 +78,7 @@ if (roll == 4) {
 . . . . .
 `)
 } else if (roll == 3) {
-    basic.plotImage(`
+    basic.showLeds(`
 . . . . .
 . # . # .
 . . . . .
@@ -92,9 +96,10 @@ Note: students are only required to write the bottom half of this answer, starti
 
 <br />
 
-```
+```blocks
+let roll = Math.random(6)
 if (roll == 3) {
-    basic.plotImage(`
+    basic.showLeds(`
 . . . . .
 . # . # .
 . . . . .
@@ -102,7 +107,7 @@ if (roll == 3) {
 . . . . .
 `)
 } else if (roll == 2) {
-    basic.plotImage(`
+    basic.showLeds(`
 # . . . .
 . . . . .
 . . # . .

docs/lessons/die-roll/quiz.md

@@ -6,7 +6,7 @@ Create a die when the BBC micro:bit is shaken
 
 ## Directions
 
-Use this activity document to guide your work in the [die roll tutorial](/microbit/lessons/die-roll/tutorial).
+Use this activity document to guide your work in the [die roll tutorial](/microbit/lessons/die-roll/activity).
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 

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
 
@@ -12,6 +12,8 @@ While Loop
 
 * [activity](/microbit/lessons/digi-yoyo/activity)
 * [challenges](/microbit/lessons/digi-yoyo/challenges)
+* [quiz](/microbit/lessons/digi-yoyo/quiz)
+* [quiz answers](/microbit/lessons/digi-yoyo/quiz-answers)
 
 ## Prior learning/place of lesson in scheme of work
 
@@ -19,21 +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/digi-yoyo/activity.md

@@ -18,7 +18,6 @@ let count = 0
 
 Add a while loop that will loop over and over until the variable `count` equals 10.
 
-![](/static/mb/blocks/lessons/digi-yoyo-1.jpg)
 
 ```blocks
 let count = 0
@@ -48,7 +47,7 @@ let count = 0
 while (count < 10) {
     basic.pause(100)
      basic.showNumber(count)
-    count == count + 1
+    count = count + (count - 1)
 }
 ```
 

docs/lessons/digi-yoyo/challenges.md

@@ -69,5 +69,7 @@ Now, we need `count` to decrease by one after the micro:bit has displayed the va
 We can do this by adding this line:
 
 ```blocks
-let count = count + (count - 1);
+let count = 0; 
+count = count + (count - 1);
+
 ```

docs/lessons/digi-yoyo/quiz-answers.md

@@ -16,7 +16,7 @@ A loop that repeats code while a condition is true.
 
 <br/>
 
-```
+```blocks
 let count = 0
 ```
 
@@ -26,7 +26,8 @@ let count = 0
 
 <br/>
 
-```
+```blocks
+let count = 0
 while (count < 5) {
     count = count + 1
 }

docs/lessons/digi-yoyo/quiz.md

@@ -6,7 +6,7 @@ Create a counter with a while loop
 
 ## Directions
 
-Use this activity document to guide your work in the [digi yoyo tutorial](/microbit/lessons/digi-yoyo/tutorial)
+Use this activity document to guide your work in the [digi yoyo tutorial](/microbit/lessons/digi-yoyo/activity)
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 

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
 
@@ -10,10 +10,8 @@ Acceleration
 
 * [activity](/microbit/lessons/glowing-pendulum/activity)
 * [challenges](/microbit/lessons/glowing-pendulum/challenges)
-
-## Class
-
-Year 7
+* [quiz](/microbit/lessons/glowing-pendulum/quiz)
+* [quiz answers](/microbit/lessons/glowing-pendulum/quiz-answers)
 
 ## Prior learning/place of lesson in scheme of work
 
@@ -21,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(`
     . . . . .
     . . . . .
@@ -43,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
 
@@ -29,16 +29,19 @@ let acceleration = input.acceleration("y")
 <br/>
 
 ```blocks
-let acceleration = math.abs(acceleration)
+let acceleration = input.acceleration(Dimension.X)
+let accelerationAbsolute = Math.abs(acceleration)
 ```
 
-## 4. Write the code that uses the acceleration value from question #3 to set the brightness on the BBC micro:bit.
+## 4. Write the code to use the acceleration value from question 3 to set the brightness on the BBC micro:bit.
 
 <br/>
 
 ```blocks
-let acceleration = acceleration / 4
-led.setBrightness(acceleration)
+let accelerationX = input.acceleration(Dimension.X)
+let accelerationAbsolute = Math.abs(accelerationX)
+let accelerationDivided = accelerationX / 4
+led.setBrightness(accelerationX)
 ```
 
 ## 5. Write the code that tuns all the LEDs on (as the image displays below)

docs/lessons/glowing-pendulum/quiz.md

@@ -1,12 +1,12 @@
 # glowing pendulum quiz
 
-construct a pendulum that glows using acceleration #LED #number #math #acceleration #docs
+construct a pendulum that glows using acceleration.
 
 ## Name
 
 ## Directions
 
-Use this activity document to guide your work in the [glowing pendulum tutorial](/microbit/lessons/glowing-pendulum/tutorial)
+Use this activity document to guide your work in the [glowing pendulum tutorial](/microbit/lessons/glowing-pendulum/activity)
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 
@@ -22,7 +22,7 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
 
 <br/>
 
-## 4. Write the code that uses the acceleration value from question #3 to set the brightness on the BBC micro:bit.
+## 4. Write the code to include acceleration value question 3 to set the brightness on the BBC micro:bit.
 
 <br/>
 

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
 
@@ -12,6 +12,8 @@ Math - Pick Random
 
 * [activity](/microbit/lessons/guess-the-number/activity)
 * [challenges](/microbit/lessons/guess-the-number/challenges)
+* [quiz](/microbit/lessons/guess-the-number/quiz)
+* [quiz answers](/microbit/lessons/guess-the-number/quiz-answers)
 
 ## Prior learning/place of lesson in scheme of work
 
@@ -19,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).
 
@@ -31,7 +31,7 @@ let randomNumber = Math.random(10)
 If the rectangle below represents the BBC micro:bit, shade the areas that will be displayed. Explain why that particular area is shaded.
 
 ```blocks
-randomNumber = Math.random(10)
+let randomNumber = Math.random(10)
 ```
 
 

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

@@ -1,12 +1,12 @@
 # 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
 
 ## Directions
 
-Use this activity document to guide your work in the [guess the number tutorial](/microbit/lessons/guess-the-number/tutorial).
+Use this activity document to guide your work in the [guess the number tutorial](/microbit/lessons/guess-the-number/activity).
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 

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
 
@@ -10,10 +10,6 @@ Hack your headphone
 
 * [activity](/microbit/lessons/hack-your-headphones/activity)
 
-## Class
-
-Year 7
-
 ## Prior learning/place of lesson in scheme of work
 
 Learn how to convert your BBC micro:bit into a music player using pins P0 and GND, headphones (or speakers), as well as crocodile clips (or spring clips).

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,17 +1,11 @@
-# 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
 
-Complete the following guided tutorial:
+Your beginning code should look like this:
 
-* [tutorial](/microbit/lessons/headbands/tutorial)
-
-At the tend of the tutorial, click `keep editing`. Your code should look like this:
-
-```
-coll = (<string[]>[])
+```blocks 
+let coll = (<string[]>[])
 coll.push("puppy")
 coll.push("clock")
 coll.push("night")
@@ -32,9 +26,23 @@ game.startCountdown(30000)
 
 Let's add more words for the player to act out! But first, we need to increase the time in one round to give the player more time get through all the words. Let's change the `game->start countdown` statement.
 
-```
-// **. . .**
-game.startCountdown(60000) // ***
+```blocks
+let coll = (<string[]>[])
+coll.push("puppy")
+coll.push("clock")
+coll.push("night")
+coll.push("cat")
+coll.push("cow")
+input.onLogoUp(() => {
+    let index = Math.random(coll.length)
+    let word = coll[index]
+    basic.showString(word, 150)
+})
+input.onScreenDown(() => {
+    game.addScore(1)
+})
+
+game.startCountdown(60000) 
 ```
 
 * Run your code to see if it works as expected
@@ -43,19 +51,26 @@ game.startCountdown(60000) // ***
 
 Now let's add 5 more words to our list of charade words. Right above the the line `word:=coll->at(index)` add 5 lines that say `coll->add("")`. In this example, we will add the words **bicycle, telephone, sun, car, and ant** but you can add whatever words you like.
 
-```
-// . . .
-coll.push("puppy")
+```blocks
+let coll.push("puppy")
 coll.push("clock")
 coll.push("night")
 coll.push("cat")
 coll.push("cow")
-coll.push("bicycle") // ***
-coll.push("telephone") // ***
-coll.push("sun") // ***
-coll.push("car") // ***
-coll.push("ant") // ***
-// . . .
+coll.push("bicycle") 
+coll.push("telephone") 
+coll.push("sun") 
+coll.push("car") 
+coll.push("ant") 
+input.onLogoUp(() => {
+    let index = Math.random(coll.length)
+    let word = coll[index]
+    basic.showString(word, 150)
+})
+input.onScreenDown(() => {
+    game.addScore(1)
+})
+game.startCountdown(30000)
 ```
 
 * Run your code to see if it works as expected.

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!
 
@@ -18,8 +18,8 @@ A 'collection' is a group of variables of the same type stored together. A 'coll
 
 ## 2. Consider the following lines of code.
 
-```
-coll = (<string[]>[])
+```blocks
+let coll = (<string[]>[])
 coll.push("puppy")
 coll.push("clock")
 ```
@@ -28,14 +28,14 @@ Write the line of code that will display the string "puppy" using `data->coll`.
 
 <br/>
 
-```
+```blocks
 basic.showString(coll[0], 150)
 ```
 
 ## 3. Consider the following lines of code.
 
-```
-coll = (<string[]>[])
+```blocks
+let coll = (<string[]>[])
 coll.push("puppy")
 coll.push("clock")
 coll.push("cat")
@@ -45,22 +45,22 @@ Write the line of code that will display the string "cat" using `data->coll`.
 
 <br/>
 
-```
+```blocks
 basic.showString(coll[2], 150)
 ```
 
 ## 4. Consider the following line of code.
 
-```
-coll = (<string[]>[])
+```blocks
+let coll = (<string[]>[])
 ```
 
 Write the five (5) lines of code that will add the following five words to `data->coll`: puppy, clock, night, cat, cow.
 
 <br/>
 
-```
-coll.push("puppy")
+```blocks
+let coll.push("puppy")
 coll.push("clock")
 coll.push("night")
 coll.push("cat")
@@ -71,7 +71,7 @@ coll.push("cow")
 
 <br/>
 
-```
+```blocks
 let index = Math.random(coll.length)
 let word = coll[index]
 ```

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!
 
@@ -18,8 +18,8 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
 
 ## 2. Write the line of code that will display the string "puppy" using "data->coll".
 
-```
-coll = (<string[]>[])
+```blocks
+let coll = (<string[]>[])
 coll.push("puppy")
 coll.push("clock")
 ```
@@ -28,8 +28,8 @@ coll.push("clock")
 
 ## 3. Write the line of code that will display the string "cat" using `"data->coll".
 
-```
-coll = (<string[]>[])
+```blocks
+let coll = (<string[]>[])
 coll.push("puppy")
 coll.push("clock")
 coll.push("cat")
@@ -40,7 +40,7 @@ coll.push("cat")
 ## 4. Write the five (5) lines of code that will add the following five words to `data->coll`: puppy, clock, night, cat, cow.
 
 ```
-coll = (<string[]>[])
+let coll = (<string[]>[])
 ```
 
 <br/>

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
 
@@ -12,6 +12,9 @@ For Loop
 
 * [activity](/microbit/lessons/looper/activity)
 * [challenges](/microbit/lessons/looper/challenges)
+* [quiz](/microbit/lessons/looper/quiz)
+* [quiz answers](/microbit/lessons/looper/quiz-answers)
+
 
 ## Class
 
@@ -23,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).
 
@@ -10,7 +10,7 @@ Answers will vary. In general, for loop refers to the code that repeats for a fi
 
 ## 2. Consider the following code
 
-```
+```blocks
 for (let i = 0; i < 4; i++) {
     basic.showNumber(i, 150)
 }
@@ -24,7 +24,7 @@ Let's create a for loop where `0` is the loop's starting value, `i` is the index
 
 ## 3. Consider the following code
 
-```
+```blocks
 for (let i1 = 0; i1 < 6; i1++) {
     basic.showNumber(i1, 150)
 }

docs/lessons/looper/quiz.md

@@ -1,12 +1,12 @@
 # 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
 
 ## Directions
 
-Use this activity document to guide your work in the [looper tutorial](/microbit/lessons/looper/tutorial)
+Use this activity document to guide your work in the [looper tutorial](/microbit/lessons/looper/activity)
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 
@@ -16,7 +16,7 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
 
 ## 2. Draw the areas where the LEDs will be lit based on the code below. Explain why you chose to draw those numbers.
 
-```
+```blocks
 for (let i = 0; i < 4; i++) {
     basic.showNumber(i, 150)
 }
@@ -28,7 +28,7 @@ for (let i = 0; i < 4; i++) {
 
 ## 3. Draw the areas where the LEDs will be lit based on the code below. Explain why you chose to draw those numbers.
 
-```
+```blocks
 for (let i1 = 0; i1 < 6; i1++) {
     basic.showNumber(i1, 150)
 }

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
 
@@ -10,6 +10,8 @@ If (Conditionals)
 
 * [activity](/microbit/lessons/magic-8/activity)
 * [challenges](/microbit/lessons/magic-8/challenges)
+* [quiz](/microbit/lessons/magic-8/quiz)
+* [quiz answers](/microbit/lessons/magic-8/quiz-answers)
 
 ## Prior learning/place of lesson in scheme of work
 
@@ -17,18 +19,13 @@ 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!")
-
 ```
 
 ## Objectives

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
 
@@ -18,21 +18,23 @@ An if statement will conditionally run code depending on whether or not a condit
 
 ## 2. Create a Variable called ``x`` and assign it to a random number between 0 and 2.
 
-```
+```blocks
 let x = Math.random(3)
 ```
 
 ## 3. Write the 'if statement' to check if ``x`` is equal to 2. Inside the 'if statement', display the string "Yes".
 
-```
+```blocks
+let x = Math.random(3)
 if (x == 2) {
     basic.showString("Yes", 150)
 }
 ```
 
-## 3. Write the 'if statement' to check if ``x`` is equal to 1. Inside the 'if statement', display the string "No."
+## 4. Write the 'if statement' to check if ``x`` is equal to 1. Inside the 'if statement', display the string "No."
 
-```
+```blocks
+let x = Math.random(3)
 if (x == 2) {
     basic.showString("Yes", 150)
 } else if (x == 1) {
@@ -42,7 +44,8 @@ if (x == 2) {
 
 ## 5. Write the code to display the string "I don't know" if the Variable ``x`` is neither 2 nor 1.
 
-```
+```blocks
+let x = Math.random(3)
 if (x == 2) {
     basic.showString("Yes", 150)
 } else if (x == 1) {

docs/lessons/magic-8/quiz.md

@@ -1,12 +1,12 @@
 # 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
 
 ## Directions
 
-Use this activity document to guide your work in the [magic 8 tutorial](/microbit/lessons/magic-8/tutorial).
+Use this activity document to guide your work in the [magic 8 tutorial](/microbit/lessons/magic-8/activity).
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 
@@ -22,7 +22,7 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
 
 <br />
 
-## 3. Write the 'if statement' to check if ``x`` is equal to 1. Inside the 'if statement', display the string "No."
+## 4. Write the 'if statement' to check if ``x`` is equal to 1. Inside the 'if statement', display the string "No."
 
 <br />
 

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
 
@@ -12,19 +12,17 @@ On Logo Up
 
 * [activity](/microbit/lessons/magic-logo/activity)
 * [challenges](/microbit/lessons/magic-logo/challenges)
+* [quiz](/microbit/lessons/magic-logo/challenges)
+* [quiz answers](/microbit/lessons/magic-logo/challenges)
 
 ## Prior learning/place of lesson in scheme of work
 
 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(`
     . . . . .
     . . . . .
@@ -32,8 +30,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
-
 ```
 
 ## Objectives

docs/lessons/magic-logo/activity.md

@@ -22,7 +22,7 @@ When the micro:bit goes logo up, the code nested under the `on logo up` function
 
 ```blocks
 input.onLogoUp(() => {
-    basic.showAnimation(`
+    basic.showLeds(`
         . . # . .
         . # # # .
         # # # # #
@@ -31,6 +31,7 @@ input.onLogoUp(() => {
         `)
 })
 
+
 ```
 
 Run your code and try to turn around the micro:bit to see the **logo up** event in action!

docs/lessons/magic-logo/challenges.md

@@ -8,7 +8,7 @@ Complete the [magic logo](/microbit/lessons/magic-logo/activity) activity and yo
 
 ```blocks
 input.onLogoUp(() => {
-    basic.showAnimation(`
+    basic.showLeds(`
         . . # . .
         . # # # .
         # # # # #
@@ -28,7 +28,7 @@ How about when the logo is down? We should display an arrow pointing downward!
 
 ```blocks
 input.onLogoUp(() => {
-    basic.showAnimation(`
+    basic.showLeds(`
         . . # . .
         . # # # .
         # # # # #
@@ -37,7 +37,7 @@ input.onLogoUp(() => {
         `)
 })
 input.onLogoDown(() => {
-    basic.showAnimation(`
+    basic.showLeds(`
         . . # . .
         . . # . .
         # # # # #

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
 
@@ -16,30 +16,35 @@ A function that will run code when the BBC micro:bit screen is facing up and ver
 
 <br/>
 
-## 2. Consider the following directions
+## 2. Write the condition that detects when the BBC micro:bit logo is facing up and vertically orientated.
+
+The `logo up` event is raised when...
+
+* the screen is facing up and the board is horizontal
+* the screen is facing down and the board is horizontal
+* the board is vertical and the logo is facing up
 
-Write the condition that detects when the BBC micro:bit logo is facing up and vertically orientated.
 
 <br/>
 
-```
+```blocks
 input.onLogoUp(() => {
 })
 ```
 
 <br/>
 
-## 3. Consider the following animation
+## 3. Write the code to display a downward pointing arrow when the logo is down.
 
 ![](/static/mb/lessons/magic-logo-0.png)
 
-Write the code to display a downward pointing arrow when the logo is down.
+
 
 <br/>
 
-```
+```blocks
 input.onLogoDown(() => {
-    basic.plotImage(`
+    basic.showLeds(`
 . . # . .
 . . # . .
 # # # # #

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
 
@@ -12,15 +12,11 @@ Use the hints from the [magic logo activity](/microbit/lessons/magic-logo/activi
 
 <br/>
 
-## 2. The `logo up` event is raised when...
+## 2. Write the condition that detects when the BBC micro:bit logo is facing up and vertically orientated.
 
-* the screen is facing up and the board is horizontal
-* the screen is facing down and the board is horizontal
-* the board is vertical and the logo is facing up
-
-## 3. Consider the following animation
+## 3. Write the code to display a downward pointing arrow when the BBC micro:bit logo is down.
 
 ![](/static/mb/lessons/magic-logo-0.png)
 
-Write the code to display a downward pointing arrow when the BBC micro:bit logo is down.
+
 

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
 
@@ -12,6 +12,8 @@ Set Brightness
 
 * [activity](/microbit/lessons/night-light/activity)
 * [challenges](/microbit/lessons/night-light/challenges)
+* [quiz](/microbit/lessons/night-light/quiz)
+* [quiz answers](/microbit/lessons/night-light/quiz-answers)
 
 ## Prior learning/place of lesson in scheme of work
 
@@ -19,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(`
     . . . . .
     . . . . .
@@ -31,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).
 
@@ -16,9 +16,15 @@ If the rectangle above represents the BBC micro:bit, write the code to set all t
 
 <br />
 
-```
+```blocks
 led.setBrightness(255)
-led.plotAll()
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
 ```
 
 ## 3. Consider the following image
@@ -29,9 +35,15 @@ If the rectangle above represents the BBC micro:bit, write the code to set the s
 
 <br/>
 
-```
+```blocks
 led.setBrightness(128)
-led.plotAll()
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
 ```
 
 ## 4. Consider the following image
@@ -40,7 +52,7 @@ led.plotAll()
 
 If the rectangle above represents the BBC micro:bit, write the code to turn off all the LEDs.
 
-```
+```blocks
 led.setBrightness(0)
 ```
 

docs/lessons/night-light/quiz.md

@@ -1,12 +1,12 @@
 # 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
 
 ## Directions
 
-Use this activity document to guide your work in the [night light tutorial](/microbit/lessons/night-light/tutorial)
+Use this activity document to guide your work in the [night light tutorial](/microbit/lessons/night-light/activity)
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 

docs/lessons/offset-image/activity.md

@@ -4,13 +4,9 @@ Coding challenges for the offset image tutorial. #docs
 
 ## Before we get started
 
-Complete the following guided tutorial:
+Complete the following exercise. Your code should look like this:
 
-* [tutorial](/microbit/lessons/offset-image/tutorial)
-
-At the end of the tutorial, click `keep editing`. Your code should look like this:
-
-```
+```blocks
 offset = 0
 basic.forever(() => {
     if (offset == -4) {

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/ornament-chain/activity.md

@@ -1,80 +0,0 @@
-# ornament chain activity 
-
-Build a telgraph 
-
-# micro:bit Ornament Chain
-
-![](/static/mb/lessons/ornament-chain-0.jpg)
-
-![](/static/mb/lessons/ornament-chain-1.jpg)
-
-In this project, you will build your ornament chain between micro:bits. Project duration: 15 minutes.
-
-## Materials
-
-* micro:bit, battery holder and 2 AAA batteries
-* Crocodile clips
-
-## Steps
-
-### Step 1
-
-![](/static/mb/lessons/banana-keyboard-1.png)
-
-Using the 1st crocodile clip, connect the end of the crocodile clip onto GND pin on the micro:bit.
-
-### Step 2
-
-![](/static/mb/lessons/ornament-chain-2.png)
-
-Using the 2nd crocodile clip, connect the end of the crocodile clip onto the 3V pin on the micro:bit.
-
-### Step 3
-
-![](/static/mb/lessons/ornament-chain-3.png)
-
-Using the 3rd crocodile clip, connect the end of the crocodile clip onto pin 1 of the micro:bit.
-
-### Step 4
-
-![](/static/mb/lessons/ornament-chain-4.png)
-
-Using the 4th crocodile clip, connect the end of the crocodile clip onto pin 2 of the micro:bit.
-
-### Step 5
-
-![](/static/mb/lessons/ornament-chain-5.png)
-
-Using the 1st crocodile clip, connect the unattached end of the crocodile clip onto the GND on the 2nd micro:bit.
-
-### Step 6
-
-![](/static/mb/lessons/ornament-chain-6.png)
-
-Using the 2nd crocodile clip, connect the unattached end of the crocodile clip onto the 3V pin on the 2nd micro:bit.
-
-### Step 7
-
-![](/static/mb/lessons/ornament-chain-7.png)
-
-Using the 3rd crocodile clip, connect the unattached end of the crocodile clip onto pin 2 of the 2nd micro:bit.
-
-### Step 8
-
-![](/static/mb/lessons/ornament-chain-8.png)
-
-Using the 4th crocodile clip, connect the unattached end of the crocodile clip onto pin 1 of the 2nd micro:bit
-
-### Step 9
-
-![](/static/mb/lessons/ornament-chain-0.jpg)
-
-![](/static/mb/lessons/ornament-chain-1.jpg)
-
-Your ornament chain is ready!
-
-### Step 10
-
-* Connect the first micro:bit to your computer using your USB cable and run the [ornament chain](/microbit/fcicvk) script on it.
-* Connect the second micro:bit to your computer using your USB cable and run the [ornament chain](/microbit/fcicvk) script on it.
-* The first person and second person take turns pressing button A to start the ornament chain game!

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
 
@@ -10,24 +10,30 @@ Running Time
 
 * [activity](/microbit/lessons/pogo/activity)
 
-## Class
-
-Year 7
-
 ## Prior learning/place of lesson in scheme of work
 
 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
-
-* **variable** : [read more...](/microbit/reference/variables/var)
-* **arithmetic operator** : [read more...](/microbit/reference/types/number)
-* **forever** : [read more...](/microbit/reference/basic/forever)
-* **on button pressed** : [read more...](/microbit/reference/input/on-button-pressed)
-* **if** : [read more...](/microbit/reference/logic/if)
-* **clear screen** : [read more...](/microbit/reference/basic/clear-screen)
-* **show LEDs** : [read more...](/microbit/reference/basic/show-leds)
-
+```cards
+let jumps = 0
+let acc = input.acceleration(Dimension.Y)
+basic.showNumber(0)
+radio.receiveNumber()
+led.stopAnimation()
+radio.sendNumber(0)
+basic.forever(() => { })
+basic.showLeds(`
+    . . . . .
+    . # . # .
+    . . # . .
+    # . . . #
+    . # # # .
+    `)
+basic.clearScreen()
+if (true) {}
+radio.onDataReceived(() => { })
+```
 ## Objectives
 
 * learn how to create a function as a unit of code that performs a specific task and returns a result
@@ -36,25 +42,3 @@ Learn how to use running time. We will be learning how to create a pogo game usi
 * learn how to conditionally run code depending on whether a condition is true or not
 * learn how to run code when an input button is pressed
 * learn how to pause your code for the specified number of milliseconds
-
-## Progression Pathways / Computational Thinking Framework
-
-#### Algorithms
-
-* Designs solutions (algorithms) that use repetition and two-way  selection, ie if, then and else.(AL)
-* Uses diagrams to express solutions.(AB)
-*  Uses logical reasoning to predict  outputs, showing an awareness of inputs (AL)
-* Represents solutions using a structured notation (AL) (AB)
-
-#### Programming & Development
-
-* Creates programs that implement algorithms to achieve given goals (AL)
-*  Declares and assigns variables(AB)
-* Uses post-tested loop e.g.‘until’,and a sequence of selection statements in programs,including an if,then and else statement(AL)
-* Understands the difference between, and appropriately uses if and if, then and else statements(AL)
-* Uses a variable and relational operators within a loop to govern termination (AL) (GE)
-* Uses a range of operators and expressions e.g. Boolean, and applies them in the context of program control. (AL)
-* Selects the appropriate data types(AL) (AB
-
-Computational Thinking Concept: AB = Abstraction; DE = Decomposition; AL = Algorithmic Thinking; EV = Evaluation; GE = Generalisation
-

docs/lessons/pogo/activity.md

@@ -8,29 +8,159 @@ Welcome! This activity will teach how to construct a pendulum that glows using a
 
 Create a **forever** loop that will constantly display the appropriate brightness on the LED display.  Now let's measure the acceleration on the `y` axis and store that value in a variable. The `acceleration(y)` function will provide the value.
 
-![](/static/mb/blocks/lessons/pogo-0.jpg)
+```blocks
+basic.forever(() => {
+    let acc = input.acceleration(Dimension.Y)
+})
+```
 
 Since the micro:bit will be swinging up and down, we need to store the variable called jumps. We will set the variable called jumps to 0 to store the number 0.
 
-![](/static/mb/blocks/lessons/pogo-1.jpg)
+```blocks
+let jumps = 0
+basic.forever(() => {
+    let acc = input.acceleration(Dimension.Y)
+})
+```
 
-The function `acceleration(y)` gets the acceleration value (milli g-force), in the `y` dimension. If the `acceleration(y)`is greater than 2000 milli g-force, we will change jumps by 1.
+The function `acceleration(y)` gets the acceleration value (milli g-force), in the `y` dimension. If the `acceleration(y)`is greater than 2000 milli g-force, we will change jumps by 1. If jumping is greater than 2000 milli-gravities, then change jumps by 1 and display a smiley on the BBC micro:bit. Finally, we will remove the smiley image from the screen
 
-If the `acceleration(y)`is greater than 2000 milli g-force, we will display the image with `show LEDs` to display a smiley face on the LEDs and `clear screen` to to turn off all the LED lights on the LED screen.
 
-![](/static/mb/blocks/lessons/pogo-2.jpg)
+```blocks
+let jumps = 0
+basic.forever(() => {
+    let acc = input.acceleration(Dimension.Y)
+    if (acc > 2000) {
+        jumps = jumps + 1;
+        basic.showLeds(`
+            . . . . .
+            . # . # .
+            . . # . .
+            # . . . #
+            . # # # .
+            `)
+        basic.clearScreen()
+    }
+})
+```
 
-Now let's register an event handler that will execute whenever an input button (A) is pressed during program execution.
+Now let's register an event handler that will execute whenever an input button (A) is pressed during program execution. If you press button A, then show the number of jumps greater than 2000 milli-gravities on the BBC micro:bit.
 
-![](/static/mb/blocks/lessons/pogo-3.jpg)
+```blocks
+let jumps = 0
+basic.forever(() => {
+    let acc = input.acceleration(Dimension.Y)
+    if (acc > 2000) {
+        jumps = jumps + 1;
+        basic.showLeds(`
+            . . . . .
+            . # . # .
+            . . # . .
+            # . . . #
+            . # # # .
+            `)
+        basic.clearScreen()
+    }
+})
+input.onButtonPressed(Button.A, () => {
+    basic.showNumber(jumps)
+})
+```
 
-Let's show what the brightness of the micro:bit is by turning all the LEDs on!
+If you press button A+B together, then reset the jump counter to 0 on the BBC micro:bit. Finally, we will show the show the jump counter on the micro:bit
 
-![](/static/mb/blocks/lessons/glowing-pendulum-5.png)
 
-### ~avatar avatar
+```blocks
+let jumps = 0
+basic.forever(() => {
+    let acc = input.acceleration(Dimension.Y)
+    if (acc > 2000) {
+        jumps = jumps + 1;
+        basic.showLeds(`
+            . . . . .
+            . # . # .
+            . . # . .
+            # . . . #
+            . # # # .
+            `)
+        basic.clearScreen()
+    }
+})
+input.onButtonPressed(Button.A, () => {
+    basic.showNumber(jumps)
+})
+input.onButtonPressed(Button.AB, () => {
+    let jumps = 0
+    basic.showNumber(jumps)
+})
 
-Excellent, you're ready to continue with the [challenges](/microbit/lessons/glowing-pendulum/challenges)!
+```
 
-### ~
+We want to setup the radio communication between an additional micro:bit. We first must send number for jumps. The additional micro:bit will receive the number and show number on data received. We are now displaying the current jump count on the second micro:bit
 
+```blocks
+let jumps = 0
+basic.forever(() => {
+    let acc = input.acceleration(Dimension.Y)
+    if (acc > 2000) {
+        jumps = jumps + 1;
+        radio.sendNumber(jumps)
+        basic.showLeds(`
+            . . . . .
+            . # . # .
+            . . # . .
+            # . . . #
+            . # # # .
+            `)
+        basic.clearScreen()
+    }
+})
+input.onButtonPressed(Button.A, () => {
+    basic.showNumber(jumps)
+})
+input.onButtonPressed(Button.AB, () => {
+    let jumps = 0
+    basic.showNumber(jumps)
+})
+radio.onDataReceived(() => {
+    basic.showNumber(radio.receiveNumber())
+})
+
+```
+We want to stop animation so every time the number of jumps increase by 1 the second micro:bit will not also display smiley from show leds. So we add the code stop animation
+
+```blocks
+let jumps = 0
+basic.forever(() => {
+    let acc = input.acceleration(Dimension.Y)
+    if (acc > 2000) {
+        jumps = jumps + 1;
+        radio.sendNumber(jumps)
+        basic.showLeds(`
+            . . . . .
+            . # . # .
+            . . # . .
+            # . . . #
+            . # # # .
+            `)
+        basic.clearScreen()
+    }
+})
+input.onButtonPressed(Button.A, () => {
+    basic.showNumber(jumps)
+})
+input.onButtonPressed(Button.AB, () => {
+    let jumps = 0
+    basic.showNumber(jumps)
+})
+radio.onDataReceived(() => {
+    basic.showNumber(radio.receiveNumber())
+    led.stopAnimation()
+})
+
+```
+
+
+Connect the first micro:bit to your computer using your USB cable and run the pogo script on it.
+Connect the second micro:bit to your computer using your USB cable and run the pogo script on it.
+The first person and second person take turns jumping in the “y” direction while the other player uses the micro:bit to track the results on the micro:bit!

docs/lessons/prank-wifi.md

@@ -0,0 +1,9 @@
+# prank wifi lesson
+
+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

@@ -4,46 +4,42 @@ create a fake wifi app to trick your friends. #docs
 
 ## Before we get started
 
-Complete the following guided tutorial:
+Complete the following exercise. Your code should look like this:
 
-* [tutorial](/microbit/lessons/prank-wifi/tutorial)
-
-At the end of the tutorial, click `keep editing`. Your code should look like this:
-
-```
+```blocks
 basic.showString("Check Wifi", 150)
 basic.forever(() => {
-    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))
     let sum = xAccel + yAccel + zAccel
     if (sum < 1400) {
-        basic.plotImage(`
-. . . . .
-. . . . .
-. . # . .
-. # # . .
-# # # . .
-`)
+        basic.showLeds(`
+            . . . . .
+            . . . . .
+            . . # . .
+            . # # . .
+            # # # . .
+            `)
     } else if (sum >= 1400 && sum < 1680) {
-        basic.plotImage(`
-. . . . .
-. . . # .
-. . # # .
-. # # # .
-# # # # .
-`)
-    }
-    else if (sum >= 1680) {
-        basic.plotImage(`
-. . . . .
-. . . . .
-. . . . .
-. . . . .
-# . . . .
-`)
+        basic.showLeds(`
+            . . . . .
+            . . . # .
+            . . # # .
+            . # # # .
+            # # # # .
+            `)
+    } else if (sum >= 1680) {
+        basic.showLeds(`
+            . . . . .
+            . . . . .
+            . . . . .
+            . . . . .
+            # . . . .
+            `)
     }
 })
+
 ```
 
 **Challenge 1**
@@ -52,19 +48,17 @@ What if wanted to show the maximum connectivity of wifi instead of just 1, 3, or
 
 Let's start by changing the first **IF** statement to `if sum <1200`.
 
-Edit this line: **if** sum <1400 **then**
+Edit this line: if sum is greater than 1400 then just click on the `1400` and backspace until you can add your own number of `1200`.
 
-Just click on the `1400` and backspace until you can add your own number of `1200`.
-
-```
+```blocks
 basic.showString("Check Wifi", 150)
 basic.forever(() => {
-    let xAccel1 = math.abs(input.acceleration("x"))
-    let yAccel1 = math.abs(input.acceleration("y"))
-    let zAccel1 = math.abs(input.acceleration("z"))
+    let xAccel1 = Math.abs(input.acceleration(Dimension.X))
+    let yAccel1 = Math.abs(input.acceleration(Dimension.Y))
+    let zAccel1 = Math.abs(input.acceleration(Dimension.Z))
     let sum1 = xAccel1 + yAccel1 + zAccel1
     if (sum1 < 1200) {
-        basic.plotImage(`
+        basic.showLeds(`
 . . . . .
 . . . . .
 . . # . .
@@ -72,7 +66,7 @@ basic.forever(() => {
 # # # . .
 `)
     } else if (sum1 >= 1400 && sum1 < 1680) {
-        basic.plotImage(`
+        basic.showLeds(`
 . . . . .
 . . . # .
 . . # # .
@@ -81,7 +75,7 @@ basic.forever(() => {
 `)
     }
     else if (sum1 >= 1680) {
-        basic.plotImage(`
+        basic.showLeds(`
 . . . . .
 . . . . .
 . . . . .
@@ -96,15 +90,15 @@ basic.forever(() => {
 
 Let's add an **IF** at the bottom of your code that checks to see if `sum >= to 1200` **and** if `sum <1400`
 
-```
+```blocks
 basic.showString("Check Wifi", 150)
 basic.forever(() => {
-    let xAccel2 = math.abs(input.acceleration("x"))
-    let yAccel2 = math.abs(input.acceleration("y"))
-    let zAccel2 = math.abs(input.acceleration("z"))
+    let xAccel2 = Math.abs(input.acceleration(Dimension.X))
+    let yAccel2 = Math.abs(input.acceleration(Dimension.Y))
+    let zAccel2 = Math.abs(input.acceleration(Dimension.Z))
     let sum2 = xAccel2 + yAccel2 + zAccel2
     if (sum2 < 1200) {
-        basic.plotImage(`
+        basic.showLeds(`
 . . . . .
 . . . . .
 . . # . .
@@ -112,7 +106,7 @@ basic.forever(() => {
 # # # . .
 `)
     } else if (sum2 >= 1400 && sum2 < 1680) {
-        basic.plotImage(`
+        basic.showLeds(`
 . . . . .
 . . . # .
 . . # # .
@@ -121,7 +115,7 @@ basic.forever(() => {
 `)
     }
     else if (sum2 >= 1680) {
-        basic.plotImage(`
+        basic.showLeds(`
 . . . . .
 . . . . .
 . . . . .
@@ -130,18 +124,18 @@ basic.forever(() => {
 `)
     }
     if (sum2 >= 1200 && sum2 < 1400) {
-        basic.plotImage(`
+        basic.showLeds(`
 . . . . #
 . . . # #
 . . # # #
 . # # # #
 # # # # #
-`) // ***
+`) 
     }
 })
 ```
 
 **Challenge 3**
 
-Now it's your turn! Be creative and change the Wifi meter images to your own wifi image you're sure will prank your friends by editing the lines that call `plot image()`.
+Now it's your turn! Be creative and change the Wifi meter images to your own wifi image you're sure will prank your friends by editing the lines that call `showLeds()`.
 

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
 
@@ -14,10 +14,10 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
 
 <br/>
 
-```
-let xAccel = math.abs(input.acceleration("x"))
-let yAccel = math.abs(input.acceleration("y"))
-let zAccel = math.abs(input.acceleration("z"))
+```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))
 ```
 
 <br/>
@@ -28,7 +28,10 @@ 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
 ```
 
@@ -38,9 +41,13 @@ 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.plotImage(`
+    basic.showLeds(`
 . . . . .
 . . . . .
 . . # . .
@@ -58,9 +65,13 @@ 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.plotImage(`
+    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.plotImage(`
+    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,12 +1,12 @@
 # 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
 
 ## Directions
 
-Use this activity document to guide your work in the [rock paper scissors tutorial](/microbit/lessons/rock-paper-scissors/tutorial).
+Use this activity document to guide your work in the [rock paper scissors tutorial](/microbit/lessons/rock-paper-scissors/activity).
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 
@@ -16,7 +16,7 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
 
 ## 2. Draw which LEDs are ON after running this code and the random number returned is 0
 
-```
+```blocks
 let img = images.createImage(`
 . . . . . # # # # # . . . . #
 . # # # . # . . . # # # . # .
@@ -36,7 +36,7 @@ img.showImage(offset)
 
 ## 3. Draw which LEDs are ON after running this code with an offset of 5. This would occur if the random number returned is 1.
 
-```
+```blocks
 let img_ = images.createImage(`
 . . . . . # # # # # . . . . #
 . # # # . # . . . # # # . # .
@@ -56,7 +56,7 @@ img.showImage(offset)
 
 ## 4. Draw which LEDs are ON after running this code with an offset of 10. This would occur if the random number returned is 2.
 
-```
+```blocks
 let img_1 = images.createImage(`
 . . . . . # # # # # . . . . #
 . # # # . # . . . # # # . # .

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
 
@@ -10,10 +10,8 @@ While Loop
 
 * [activity](/microbit/lessons/rotation-animation/activity)
 * [challenges](/microbit/lessons/rotation-animation/challenges)
-
-## Class
-
-Year 7
+* [quiz](/microbit/lessons/rotation-animation/quiz)
+* [quiz answers](/microbit/lessons/rotation-animation/quiz-answers)
 
 ## Prior learning/place of lesson in scheme of work
 
@@ -21,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(`
     . . . . .
     . . . . .
@@ -34,21 +30,16 @@ basic.showLeds(`
     . . . . .
     `)
 basic.pause(100)
-while (true) {
-
-    basic.pause(20)
-}
-
-
-
+while (true) {}
+basic.pause(20)
 ```
 
 ## Objectives
 
-* learn how to create a global variable for a place where you can store data, accessible across functions, and in nested code blocks
-* learn how to set or change the value of a global variable
+* learn how to create a variable for a place where you can store data, accessible across functions, and in nested code blocks
+* learn how to set or change the value of a  variable
 * learn how to repeat code while a condition is true
-* learn how to declare a global boolean variable to determine which code will execute next
+* learn how to declare a boolean variable to determine which code will execute next
 * learn how to run code when an input button is pressed
 * learn how to show a series of image frames on the LED screen
 * learn how to pause your code for the specified number of milliseconds

docs/lessons/rotation-animation/challenges.md

@@ -54,9 +54,6 @@ Now let's add to this by creating a condition for on button pressed `A` before t
 ```blocks
 
 let rotating = true;
-input.onButtonPressed(Button.A, () => {
-    serial.writeLine("hello")
-})
 while (rotating) {
     serial.writeLine("loop")
     basic.showLeds(`
@@ -88,8 +85,9 @@ while (rotating) {
         . . . . .
         `)
 }
-
-
+input.onButtonPressed(Button.A, () => {
+    serial.writeLine("hello")
+})
 
 ```
 
@@ -101,10 +99,6 @@ Now that we have the on button pressed condition, let's make the animation stop
 
 ```blocks
 let rotating = true;
-input.onButtonPressed(Button.A, () => {
-    serial.writeLine("hello")
-    rotating = false
-})
 while (rotating) {
     serial.writeLine("loop")
     basic.showLeds(`
@@ -136,7 +130,10 @@ while (rotating) {
         . . . . .
         `)
 }
-
+input.onButtonPressed(Button.A, () => {
+    serial.writeLine("hello")
+    rotating = false
+})
 
 ```
 

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

@@ -1,47 +1,85 @@
 # 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).
 
-## 1. What is a "global variable"?
+## 1. What is a " variable"?
 
-Answers may vary. A global variable is a place where you can store data so that you can use it later in your code.
+Answers may vary. A variable is a place where you can store data so that you can use it later in your code.
 
-## 2. Consider the following directions
+## 2. Write the code to create a ** variable** called `foo` that stores a boolean and initialize it to **false**.
 
-Write the code to create a **global variable** called `foo` that stores a boolean and initialize it to **false**.
 
-```
-rotating = true
+
+```blocks
+let rotating = true;
 ```
 
-## 3. Consider the following code
+## 3. Explain what this line of code does.
 
-```
+```blocks
+let rotating = true;
 while (rotating) {
+    basic.showLeds(`
+        . . . . .
+        . . . . .
+        . . # . .
+        . . . . .
+        . . . . .
+        `)
+    basic.showLeds(`
+        . . . . .
+        . . . . .
+        . . . . .
+        . . . . .
+        . . . . .
+        `)
 }
+
 ```
 
-Explain what this line of code does.
+
 
 <br/>
 
-It is a **while** loop that will be executed only if the **global variable** called `rotating` is **true**.
+It is a **while** loop that will be executed only if the ** variable** called `rotating` is **true**.
 
-## 4. Consider the following code
+## 4. If the rectangle below represents the BBC micro:bit, shade the areas that will be displayed. Explain why that particular area is shaded.
 
-```
-basic.showAnimation(`
-# . . . . . . # . . . . . . # . . . . .
-. # . . . . . # . . . . . # . . . . . .
-. . # . . . . # . . . . # . . # # # # #
-. . . # . . . # . . . # . . . . . . . .
-. . . . # . . # . . # . . . . . . . . .
-`, 400)
+```blocks
+basic.showLeds(`
+        . . # . .
+        . . # . .
+        . . # . .
+        . . # . .
+        . . # . .
+        `)
+basic.showLeds(`
+        . . . . .
+        . . . . .
+        # # # # #
+        . . . . .
+        . . . . .
+        `)
+basic.showLeds(`
+        . . . . #
+        . . . # .
+        . . # . .
+        . # . . .
+        # . . . .
+        `)
+basic.showLeds(`
+        . . . . #
+        . . . # .
+        . . # . .
+        . # . . .
+        # . . . .
+        `)
+   
 ```
 
-If the rectangle below represents the BBC micro:bit, shade the areas that will be displayed. Explain why that particular area is shaded.
+
 
 ![](/static/mb/lessons/rotation-animation-0.png)
 

docs/lessons/rotation-animation/quiz.md

@@ -1,42 +1,80 @@
 # 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
 
 ## Directions
 
-Use this activity document to guide your work in the [rotation animation tutorial](/microbit/lessons/rotation-animation/tutorial).
+Use this activity document to guide your work in the [rotation animation tutorial](/microbit/lessons/rotation-animation/activity).
 
 Answer the questions while completing the tutorial. Pay attention to the dialogues!
 
-## 1. What is a "global variable"?
+## 1. What is a " variable"?
 
 <br />
 
-## 2. Write the code to create a global variable called foo that stores a boolean and initialize it to false.
+## 2. Write the code to create a variable called foo that stores a boolean and initialize it to false.
 
 <br/>
 
-## 3. Explain why you use a while loop with a global variable
+## 3. Explain why you use a while loop with a variable
 
-```
+```blocks
+let rotating = true;
 while (rotating) {
+    basic.showLeds(`
+        . . . . .
+        . . . . .
+        . . # . .
+        . . . . .
+        . . . . .
+        `)
+    basic.showLeds(`
+        . . . . .
+        . . . . .
+        . . . . .
+        . . . . .
+        . . . . .
+        `)
 }
+
 ```
 
 <br/>
 
 ## 4. Draw the areas on the micro:bits to illustrate the code below. Explain why you chose to draw in those areas.
 
-```
-basic.showAnimation(`
-# . . . . . . # . . . . . . # . . . . .
-. # . . . . . # . . . . . # . . . . . .
-. . # . . . . # . . . . # . . # # # # #
-. . . # . . . # . . . # . . . . . . . .
-. . . . # . . # . . # . . . . . . . . .
-`, 400)
+```blocks
+basic.showLeds(`
+        . . # . .
+        . . # . .
+        . . # . .
+        . . # . .
+        . . # . .
+        `)
+basic.showLeds(`
+        . . . . .
+        . . . . .
+        # # # # #
+        . . . . .
+        . . . . .
+        `)
+basic.showLeds(`
+        . . . . #
+        . . . # .
+        . . # . .
+        . # . . .
+        # . . . .
+        `)
+basic.showLeds(`
+        . . . . #
+        . . . # .
+        . . # . .
+        . # . . .
+        # . . . .
+        `)
+   
 ```
 
 ![](/static/mb/lessons/looper-2.png)

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/smiley/activity.md

@@ -13,14 +13,14 @@ Welcome! This tutorial will help you make a smiley face blink. Let's get started
 Create an animation with an image displaying a smiley face and the next image with no LEDs lit up. This will make it look like the smiley face is blinking as the display switches between images.
 
 ```blocks
-basic.showAnimation(`
+basic.showLeds(`
     . # . # .
     . # . # .
     . . . . .
     # . . . #
     . # # # .
     `)
-basic.showAnimation(`
+basic.showLeds(`
     . . . . .
     . . . . .
     . . . . .

docs/lessons/smiley/challenges.md

@@ -8,14 +8,14 @@ Complete the [smiley activity](/microbit/lessons/smiley/activity) and your code
 
 
 ```blocks
-basic.showAnimation(`
+basic.showLeds(`
     . # . # .
     . # . # .
     . . . . .
     # . . . #
     . # # # .
     `)
-basic.showAnimation(`
+basic.showLeds(`
     . . . . .
     . . . . .
     . . . . .
@@ -33,14 +33,14 @@ Let's make add code that will run when button A is pressed!
 
 
 ```blocks
-basic.showAnimation(`
+basic.showLeds(`
     . # . # .
     . # . # .
     . . . . .
     # . . . #
     . # # # .
     `)
-basic.showAnimation(`
+basic.showLeds(`
     . . . . .
     . . . . .
     . . . . .
@@ -59,14 +59,14 @@ input.onButtonPressed(Button.A, () => {
 Now, we want to show a frowny face when this button is pressed. Let's show the LEDs.
 
 ```blocks
-basic.showAnimation(`
+basic.showLeds(`
     . # . # .
     . # . # .
     . . . . .
     # . . . #
     . # # # .
     `)
-basic.showAnimation(`
+basic.showLeds(`
     . . . . .
     . . . . .
     . . . . .
@@ -74,7 +74,7 @@ basic.showAnimation(`
     . . . . .
     `)
 input.onButtonPressed(Button.A, () => {
-    basic.showAnimation(`
+    basic.showLeds(`
         . # . # .
         . # . # .
         . . . . .

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
 
@@ -51,7 +51,7 @@ basic.forever(() => {
         . . # . .
         `)
 })
-```blocks
+```
 
 Run your code in the simulator or download it to your BBC micro:bit to see what happens!
 

docs/lessons/snowflake-fall/challenges.md

@@ -6,25 +6,59 @@ Coding challenges for snowflake fall.
 
 Complete the [snowflake fall](/microbit/lessons/snowflake-fall/activity) activity and your code will look like this:
 
-![](/static/mb/blocks/lessons/snowflake-fall-1.jpg)
+```blocks
+basic.forever(() => {
+    basic.showLeds(`
+        . . . . .
+        . . # . .
+        . # # # .
+        . . # . .
+        . . . . .
+        `)
+    basic.showLeds(`
+        . . # . .
+        . # . # .
+        # . . . #
+        . # . # .
+        . . # . .
+        `)
+})
+```
 
 ### Challenge 1
 
 ### @video td/videos/snowflake-fall-1
 
-Let's begin creating our falling effect by adding another snowflake with `show LEDs` that displays a different snowflake pattern after the first one. We need 2 frames in the new animation that display both the first and the second snowflake images.
-
-![](/static/mb/blocks/lessons/snowflake-fall-2.jpg)
-
-* Run your program to see the cool animation.
-
-### Challenge 2
-
-### @video td/videos/snowflake-fall-2
-
 To finalize our snowflake fall, let's add a different snowflake pattern.
 
-![](/static/mb/blocks/lessons/snowflake-fall-3.jpg)
+```blocks
+
+basic.forever(() => {
+    basic.showLeds(`
+        . . . . .
+        . . # . .
+        . # # # .
+        . . # . .
+        . . . . .
+        `)
+    basic.showLeds(`
+        . . # . .
+        . # . # .
+        # . . . #
+        . # . # .
+        . . # . .
+        `)
+    basic.showLeds(`
+        . # . # .
+        # # # # #
+        . # . # .
+        # # # # #
+        . # . # .
+        `)
+})
+
+```
+
 
 * Run your program and see if it works.