0.2.145

Add few more radio documentation pages

.gitignore

@@ -1,9 +1,11 @@
 node_modules
+yotta_modules
+yotta_targets
 built
 typings
 tmp
 temp
-projects
+projects/**
 win10/app/bin
 win10/app/bld
 win10/*.opendb

.travis.yml

@@ -13,4 +13,5 @@ notifications:
 cache:
   directories:
     - node_modules
+    - built/cache
 

README.md

@@ -1,26 +1,55 @@
 # micro:bit target for PXT
 
 This target allow to program a [BBC micro:bit](https://www.microbit.co.uk/) using 
-[Microsoft Programming Experience Toolkit](https://github.com/Microsoft/pxt).
+PXT ([Microsoft Programming Experience Toolkit](https://github.com/Microsoft/pxt)).
+
+* [Try it live](https://m.pxt.io)
 
 [![Build Status](https://travis-ci.org/Microsoft/pxt-microbit.svg?branch=master)](https://travis-ci.org/Microsoft/pxt-microbit)
 
-# Getting started
+## Local server
 
-Please follow instructions at https://github.com/Microsoft/pxt#running-a-target-from-localhost 
+### Setup
+
+The following commands are a 1-time setup after synching the repo on your machine.
+
+* install the PXT command line
+```
+npm install -g pxt
+```
+* install the dependencies
+```
+npm install
+```
+
+### Running
+
+Run this command to open a local web server:
+```
+pxt serve
+```
+If the local server opens in the wrong browser, make sure to copy the URL containing the local token. 
+Otherwise, the editor will not be able to load the projects.
+
+If you need modify the `.cpp` files, turn on yotta compilation with the ``-yt`` flag:
+```
+pxt serve -yt
+```
+
+To make sure you're running the latest tools, run
+```
+npm update
+```
+
+
+More instructions at https://github.com/Microsoft/pxt#running-a-target-from-localhost 
 
 ## Universal Windows App
 
 The Windows 10 app is a [Universal Windows Hosted Web App](https://microsoftedge.github.io/WebAppsDocs/en-US/win10/CreateHWA.htm)
-that wraps codemicrobit.com and provides additional features.
-
-### Sideloading
-
-* Open Windows **settings** and search for **Developer options**
-* Enable the developer mode.
-* Find the latest build under ``win10/app/AppPackages/latest`` and run the ``Add-AppDevPackage.ps1`` PowerShell script (mouse right-click, then `run with PowerShell`)
+that wraps ``m.pxt.io`` and provides additional features.
 
 ### Building
 
 * Install Visual Studio 2015 Update 2 or higher. Make sure the Windows 10 templates are installed.
-* open the ``win10/app.sln`` solution and launch the ``codemicrobit`` project.
+* open the ``win10/app.sln`` solution and launch the ``m.pxt.io`` project.

cmds/cmds.ts

@@ -1,8 +1,8 @@
 /// <reference path="../node_modules/pxt-core/built/pxt.d.ts"/>
 
-import * as fs from 'fs';
-import * as path from 'path';
-import * as child_process from 'child_process';
+import * as fs from "fs";
+import * as path from "path";
+import * as child_process from "child_process";
 
 let writeFileAsync: any = Promise.promisify(fs.writeFile)
 let execAsync: (cmd: string, options?: { cwd?: string }) => Promise<Buffer> = Promise.promisify(child_process.exec)
@@ -13,10 +13,10 @@ export function deployCoreAsync(res: ts.pxt.CompileResult) {
             if (drives.length == 0) {
                 console.log("cannot find any drives to deploy to")
             } else {
-                console.log("copy microbit.hex to " + drives.join(", "))
+                console.log(`copy ${ts.pxt.BINARY_HEX} to ` + drives.join(", "))
             }
             return Promise.map(drives, d =>
-                writeFileAsync(d + "microbit.hex", res.outfiles["microbit.hex"])
+                writeFileAsync(d + ts.pxt.BINARY_HEX, res.outfiles[ts.pxt.BINARY_HEX])
                     .then(() => {
                         console.log("wrote hex file to " + d)
                     }))

cmds/tsconfig.json

@@ -8,6 +8,6 @@
         "module": "commonjs",
         "rootDir": ".",
         "newLine": "LF",
-        "sourceMap": true
+        "sourceMap": false
     }
 }

docs/about.md

@@ -26,7 +26,7 @@ input.onButtonPressed(Button.B, () => {
 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.
 The BBC micro:bit was made possible by many [partners](https://www.microbit.co.uk/partners).
 
-The micro:bit provides a fun introduction to programming and making – switch on, program it to do something fun – wear it, customize it.
+The micro:bit provides an easy and fun introduction to programming and making – switch on, program it to do something fun – wear it, customize it.
 Just like Arduino, the micro:bit can be connected to and interact with sensors, displays, and other devices. 
 
 ## Blocks or JavaScript

docs/device/contents.md

@@ -1,6 +1,6 @@
 # micro:bit - the device
 
-The micro:bit device #docs
+The micro:bit device
 
 The micro:bit is a very capable device with many components:
 

docs/device/error-codes.md

@@ -1,6 +1,6 @@
 # Error codes
 
-The micro:bit error codes #docs
+The micro:bit error codes
 
 Your micro:bit may encounter a situation that prevents it from running your code. When this happens, a frowny face will appear on your micro:bit screen (see picture) followed by an error number.
 

docs/device/reactive.md

@@ -1,6 +1,6 @@
 # The micro:bit - a reactive system
 
-The micro:bit is a reactive system. #docs
+The micro:bit is a reactive system.
 
 ### Computing systems
 

docs/docs.md

@@ -1,8 +1,36 @@
 # Documentation
 
-Welcome to the documentation.
+```sim
+basic.forever(() => {
+  basic.showString("DOCS ");
+})
+input.onButtonPressed(Button.A, () => {
+    led.stopAnimation();
+    basic.showLeds(`
+. . . . .
+. # . # .
+. . . . .
+# . . . #
+. # # # .`);
+});
+input.onButtonPressed(Button.B, () => {
+    led.stopAnimation();
+    basic.showLeds(`
+. # . # .
+# . # . #
+# . . . #
+. # . # .
+. . # . .`);
+});
+``` 
 
+* **[getting started](/getting-started)**   
 * Browse the [API reference](/reference)
 * Learn more about the [device](/device)
 * Get started with [lessons](/lessons)
-* Learn about [libraries](/libraries) (possibly using C++)
+* Frequently Asked Question [faq](/faq)
+* Follow up with the [release notes](/release-notes)
+
+### Developers
+
+* Learn about [packages](/packages) (possibly using C++ or ARM thumb)

docs/faq.md

@@ -0,0 +1,6 @@
+# Frequently Asked Questions
+
+## Where can I get a BBC micro:bit?
+
+More information at [http://uk.farnell.com/bbc-microbit](http://uk.farnell.com/bbc-microbit).
+

docs/getting-started.md

@@ -0,0 +1,273 @@
+# Getting started
+
+Are you ready to build cool BBC micro:bit programs?
+
+Here are some challenges for you.  Unscramble the blocks in the editor
+to make real programs that work!
+
+### Happy face
+
+There are three blocks in the editor (the area to the left).
+They should look like this:
+
+```blocks
+basic.forever(() => {
+    basic.showLeds(`
+        . . . . .
+        . # . # .
+        . . . . .
+        # . . . #
+        . # # # .
+        `)
+    basic.showLeds(`
+        . . . . .
+        . . . . .
+        . . . . .
+        . . . . .
+        . . . . .
+        `)
+});
+```
+
+When you run this program, you will see a smiley face, then a blank
+screen, then a smiley again -- it never stops! (That's because of the
+``forever`` block.)
+
+To move your program from your computer to the BBC micro:bit:
+* Connect your micro:bit to the computer with the USB cable.
+* Click **Compile**.
+* Drag and drop the new file whose name ends in **.hex** into the **MICROBIT** window.
+* Wait until the yellow light stops blinking!
+
+### Happy unhappy face
+
+Draw an unhappy face instead of the blank screen.  Click on the dots
+in the second ``show leds`` block until it matches the blocks below.
+Now you have an **animation** (cartoon) that shows a happy face,
+then an unhappy one, then a happy one again, forever (or until
+you turn off your micro:bit)!
+
+```blocks
+basic.forever(() => {
+    basic.showLeds(`
+        . . . . .
+        . # . # .
+        . . . . .
+        # . . . #
+        . # # # .
+        `)
+    basic.showLeds(`
+        . . . . .
+        . # . # .
+        . . . . .
+        . # # # .
+        # . . . #
+        `)
+});
+```
+
+To move your program from your computer to the BBC micro:bit:
+* Connect your micro:bit to the computer with the USB cable.
+* Click **Compile**.
+* Drag and drop the new file whose name ends in **.hex** into the **MICROBIT** window.
+* Wait until the yellow light stops blinking!
+
+### Your turn!
+
+Pile up more ``show leds`` blocks to create your animation! Create an
+animation with at least 5 pictures.  What does this animation show?
+
+```blocks
+basic.forever(() => {
+    basic.showLeds(`
+        . . . . .
+        . # . # .
+        . . . . .
+        # . . . #
+        . # # # .
+        `)
+    basic.showLeds(`
+        . . . . .
+        . # . # .
+        . . . . .
+        # # # # #
+        . . . . .
+        `)
+    basic.showLeds(`
+        . . . . .
+        . # . # .
+        . . . . .
+        . # # # .
+        # . . . #
+        `)
+    basic.showLeds(`
+        . . . . .
+        . # . # .
+        . . . . .
+        # # # # #
+        . . . # #
+        `)
+    basic.showLeds(`
+        . . . . .
+        # . # . .
+        . . . . .
+        # . . . #
+        . # # # .
+        `)
+    basic.showLeds(`
+        . . . . .
+        . . # . #
+        . . . . .
+        # . . . #
+        . # # # .
+        `)
+});
+```
+
+To move your program from your computer to the BBC micro:bit:
+* Connect your micro:bit to the computer with the USB cable.
+* Click **Compile**.
+* Drag and drop the new file whose name ends in **.hex** into the **MICROBIT** window.
+* Wait until the yellow light stops blinking!
+
+#### ~hint
+
+You can find the ``show leds`` block in the **Basic** part of the editor.
+
+#### ~
+
+### Button A and button B
+
+This program will show the word **anteater** on the LED
+screen when you press button `A`.
+
+```blocks
+input.onButtonPressed(Button.A, () => {
+    basic.showString("anteater");
+});
+```
+
+#### ~hint
+
+The ``showString`` block can show letters, numbers, and punctuation
+on the micro:bit screen.
+
+#### ~
+
+Now try to unscramble these blocks in the editor so that the micro:bit
+shows **banana** when you press button `B`.
+
+```shuffle
+input.onButtonPressed(Button.B, () => {
+    basic.showString("banana");
+});
+```
+#### ~hint
+
+You can find the letter `B` by clicking the letter `A` on the
+``onButtonPressed`` block.
+
+#### ~
+
+#### Your turn!
+
+Can you combine these blocks so your program shows your real name
+instead of **anteater** when you press `A`, but _your secret agent
+name_ instead of **banana** when you press `B`?
+
+### Shake
+
+You can find when someone is shaking the BBC micro:bit by checking its
+**accelerometer** (it finds whether the micro:bit is speeding up or
+slowing down).
+
+Unscramble these blocks in the editor to show a frownie when someone
+shakes the micro:bit. (Ouch!)
+
+```shuffle
+input.onGesture(Gesture.Shake, () => {
+    basic.showLeds(`
+. . . . .
+. # . # .
+. . . . .
+. # # # .
+# . . . #`);
+});
+```
+
+### Tilting with gestures
+
+You can also find when someone is tilting the micro:bit left or right,
+face up or face down, and logo up or logo down (the logo is the yellow
+oval picture at the top of the board). Tilting a micro:bit like this
+is called a **gesture**.
+
+Try to build a Rock Paper Scissors game where you tilt the micro:bit
+left to show paper, right to show scissors, and down to show rock.
+
+Unscramble these blocks in the editor and try this program on a real
+micro:bit!
+
+```shuffle
+input.onGesture(Gesture.TiltLeft, () => {
+    basic.showLeds(`
+# # # # #
+# . . . #
+# . . . #
+# . . . #
+# # # # #`);
+});
+input.onGesture(Gesture.LogoDown, () => {
+    basic.showLeds(`
+. . . . .
+. # # # .
+. # # # .
+. # # # .
+. . . . .`);
+});
+input.onGesture(Gesture.TiltRight, () => {
+    basic.showLeds(`
+# # . . #
+# # . # .
+. . # . .
+# # . # .
+# # . . #`);
+});
+```
+
+### Pins
+
+You can also use the pins as buttons.  (The pins are the holes in the
+metal stripe at the bottom of the micro:bit board.)  For example, hold
+the ``GND`` button with one hand and touch the ``0`` pin (called
+``P0``) with your other hand to tell the micro:bit you're pressing it.
+
+Unscramble the blocks in the editor to show a smiley when you press
+pin ``P0``.
+
+```shuffle
+input.onPinPressed(TouchPin.P0, () => {
+    basic.showLeds(`
+. . . . .
+. # . # .
+. . . . .
+# . . . #
+. # # # .`);
+});
+```
+
+### Your turn!
+
+Use the screen, buttons, gestures, and pins to make your own fun game
+with the BBC micro:bit!  What about some of these?
+
+* A backpack burglar alarm
+* Daily news broadcaster for your class
+* Animated jewelry
+* A _complete_ animated cartoon
+* A calculator
+* A music box
+
+These are all things you can make with the BBC micro:bit by itself.
+Just think what you can do if you connect the micro:bit's pins to
+extra parts like microphones and other **sensors**!

docs/lessons.md

@@ -5,9 +5,6 @@
 
 ### ~column 
 
-## O365 Integration
-* [Science Experiments: Chart](/lessons/charting), create an app for simulating and measuring sensor data of acceleration, temperature, light level, and rotation 
-
 ## Beginner
 
 * [Beautiful Image](/lessons/beautiful-image), show a beautiful image with show LEDs
@@ -37,7 +34,7 @@
 * [Rock Paper Scissors](/lessons/rock-paper-scissors), create the classic game of rock paper scissors with if statement
 * [Truth or Dare](/lessons/truth-or-dare), a game that forces each player to reveal a secret or do something funny with if statement
 * [Spinner](/lessons/spinner), spin the arrow with multiple if statements
-* [Die Roll](/lessons/die-roll), spin with more if statements
+* [Dice Roll](/lessons/dice-roll), spin with more if statements
 * [Looper](/lessons/looper), display a series of numbers with a for loop index
 * [Strobe Light](/lessons/strobe-light), develop shapes with a nested for loops
 * [Temperature](/lessons/temperature), get the ambient temperature (degree Celsius °C)
@@ -60,6 +57,10 @@
 * [Telegraph](/lessons/telegraph), play the telegraph game between two BBC micro:bits
 * [Pogo](/lessons/pogo), create a pogo game to test your jumping abilities
 
+## Science
+* [Charting](/lessons/charting), measure and chart acceleration
+* [Seismograph](/lessons/seismograph), create a seismograph with household items
+
 ## Advanced
 * [Prank WiFi](/lessons/prank-wifi), create fake WiFi to trick your friends
 * [Speed Button](/lessons/speed-button), code a speed game with running time
@@ -70,5 +71,4 @@
 
 ### @section full
 
-The lessons promote computational thinking and computer science literacy[ read more...](/lessons/teach)
-
+The lessons promote computational thinking and computer science literacy[ read more...](/lessons/teach)

docs/lessons/answering-machine.md

@@ -1,8 +1,6 @@
 # answering machine blocks lesson
 
-create an answering machine on the BBC micro:bit #docs
-
-### @video td/videos/answering-machine-0
+Create an answering machine on the BBC micro:bit
 
 ## Topic
 
@@ -25,12 +23,8 @@ Learn how to creating a message with a **string**, `show string` to write your m
 ```cards
 basic.showString('Hi!')
 input.onButtonPressed(Button.A, () => {})
-
 ```
 
-
-* **on button pressed** : [read more...](/reference/input/on-button-pressed)
-
 ## Objectives
 
 * learn how to show a string on the LED screen one character at a time

docs/lessons/answering-machine/activity.md

@@ -4,7 +4,6 @@ Learn to create an answering machine on the micro:bit
 
 ### ~avatar avatar
 
-### @video td/videos/answering-machine-0
 
 Let's learn how to create an answering machine!
 

docs/lessons/answering-machine/challenges.md

@@ -12,8 +12,6 @@ basic.showString("ASK ME A QUESTION")
 
 ### Challenge 1
 
-### @video td/videos/answering-machine-1
-
 Now we need to reply after someone asks micro:bit a  yes or no question. We want to respond `YES` when button `A` is pressed. Add a condition for button `A` and inside it show the string `YES`.
 
 ```blocks
@@ -21,15 +19,12 @@ basic.showString("ASK ME A QUESTION")
 input.onButtonPressed(Button.A, () => {
     basic.showString("Yes")
 })
-
 ```
 
 * `Run` the code to see if it works as expected.
 
 ### Challenge 2
 
-### @video td/videos/answering-machine-2
-
 What if micro:bit's answer to the question is no? Let's have `NO` be displayed when button `B` is pressed. Add a condition for button `B` and inside it show the string `NO`.
 
 ```blocks
@@ -45,7 +40,6 @@ input.onButtonPressed(Button.B, () => {
 
 * `Run` the code to see if it works as expected.
 
-**Challenge 3**
-
-When you are asked a yes or no question, do you always say yes or no? Add a condition for `on shake` that displays `MAYBE`.
+### Challenge 3
 
+When you are asked a yes or no question, do you always say yes or no? Add a condition for `on shake` that displays `MAYBE`.

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

@@ -12,7 +12,6 @@ Answers may vary. This is a function that will show a string on the LED screen o
 
 ```blocks
 basic.showString("Y")
-
 ```
 
 ![](/static/mb/lessons/answering-machine-0.png)
@@ -22,7 +21,6 @@ basic.showString("Y")
 
 ```blocks
 basic.showString("Hi")
-
 ```
 
 ![](/static/mb/lessons/answering-machine-1.png)
@@ -35,7 +33,6 @@ basic.showString("Hi")
 
 ```blocks
 basic.showString("Z")
-
 ```
 
 

docs/lessons/beautiful-image.md

@@ -1,8 +1,6 @@
 # beautiful image lesson
 
-display beautiful images on the BBC micro:bit.
-
-### @video td/videos/beautiful-image-0
+Display beautiful images on the BBC micro:bit.
 
 ## Topic
 

docs/lessons/beautiful-image/activity.md

@@ -4,8 +4,6 @@ Generate and show a beautiful image.
 
 ### ~avatar avatar
 
-### @video td/videos/beautiful-image-0
-
 Let's learn how to show an image on the LED screen.
 
 ### ~

docs/lessons/beautiful-image/challenges.md

@@ -18,8 +18,6 @@ basic.showLeds(`
 
 ### Challenge 1
 
-### @video td/videos/beautiful-image-1-2
-
 Now show an new image that will display on the micro:bit.
 
 ```blocks
@@ -39,9 +37,9 @@ basic.showLeds(`
     `)
 ```
 
-* *Run* your code to see if it works as expected.
+* Does your code work as expected?
 
 ### Challenge 2
 
-Nice job! Why don't we create a third image that will show after the other two? Remember to add a pause before you create and show the image.
+Nice job! Why don't we create a third image that will show after the other two?
 

docs/lessons/beautiful-image/tutorial.md

@@ -0,0 +1,48 @@
+# beautiful image blocks challenges
+
+Beautiful Image tutorial. 
+
+### ~avatar avatar
+
+### @video td/videos/beautiful-image-0
+
+Rebuild the game!
+
+The blocks have been shuffled! Put them back together so that…
+
+* display images on the screen with show LEDs
+
+
+```shuffle
+basic.showLeds(`
+    # # # # #
+    # # . # #
+    # . # . #
+    # # . # #
+    # # # # #
+    `)
+basic.showLeds(`
+    # . # . #
+    . # # # .
+    . . # . .
+    . # # # .
+    # . # . #
+    `)
+basic.pause(100)
+```
+
+Hints and tips
+
+Cut out these documentation cards to help you!
+
+```cards
+basic.showLeds(`
+    . . . . .
+    . . . . .
+    . . # . .
+    . . . . .
+    . . . . .
+    `)
+basic.pause(100)
+
+```

docs/lessons/blink.md

@@ -2,8 +2,6 @@
 
 Learn how to create a blinking LED.
 
-### @video td/videos/blink-0
-
 ## Topic
 
 Plot
@@ -30,7 +28,6 @@ basic.pause(100)
 basic.forever(() => {})
 ```
 
-
 ## Objectives
 
 * learn how to turn on LED lights on the LED screen

docs/lessons/blink/activity.md

@@ -4,7 +4,15 @@ Turn an LED on and off with forever
 
 ### ~avatar avatar
 
-### @video td/videos/blink-0
+```sim
+basic.forever(() => {
+    led.plot(2, 2)
+    basic.pause(500)
+    led.unplot(2, 2)
+    basic.pause(500)
+})
+```
+Let's build a blinking light!
 
 ### ~
 
@@ -43,7 +51,6 @@ basic.forever(() => {
     led.unplot(2, 2)
     basic.pause(500)
 })
-
 ```
 
 ### ~avatar boothing

docs/lessons/blink/challenges.md

@@ -17,8 +17,6 @@ basic.forever(() => {
 
 ### Challenge 1
 
-### @video td/videos/blink-1
-
 Let's display a "smiley face" on the screen! We'll start by plotting the eyes.
 
 Add `plot(1,1)` and `plot(3,1)` under `plot(2,2)` ; then add `unplot(1,1)`, `unplot(3,1)` and `unplot(2,2)` after `pause`. When you're ready, don't forget to run your code to try it out!
@@ -38,8 +36,6 @@ basic.forever(() => {
 
 ### Challenge 2
 
-### @video td/videos/blink-2
-
 Let's add the code to plot the mouth by using `plot` and `unplot` to the following coordinates: (1,4), (2,4) and (3,4). When you're ready, don't forget to run your code to try it out!
 
 ```blocks
@@ -63,8 +59,6 @@ basic.forever(() => {
 
 ### Challenge 3
 
-### @video td/videos/blink-3
-
 Let's keep using `plot` to convert the mouth into a smiley face.
 
 ```` bitmatrix

docs/lessons/blocks-conditions.md

@@ -1,6 +1,6 @@
 # blocks - if statements
 
-An introduction to conditions for the Block Editor. #docs
+An introduction to conditions for the Block Editor.
 
 ## Introduction to conditions
 

docs/lessons/bop-it/activity.md

@@ -1,6 +1,6 @@
 # bop it challenges
 
-a game similar to "Simon Says" with the BBC micro:bit. #docs
+a game similar to "Simon Says" with the BBC micro:bit.
 
 ## Before we get started
 

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

@@ -12,17 +12,14 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
 
 ## 1. Write the code that will store the global variable named 'action' and returns a random number between 0 and 2
 
-<br/>
-
-```
-action = Math.random(3)
+```blocks
+let action = Math.random(3)
 ```
 
 ## 2. Write the code that will display the string, "PUSH A" if the global variable called 'action' is equal to 0
 
-<br />
-
-```
+```blocks
+let action = Math.random(3)
 if (action == 0) {
     basic.showString("PUSH A", 150)
 }
@@ -30,10 +27,9 @@ if (action == 0) {
 
 ## 3. Write the code that increments the score if button A is pressed when the global variable called 'action' is equal to 1
 
-<br />
-
-```
+```blocks
 input.onButtonPressed(Button.A, () => {
+    let action = Math.random(3)
     if (action == 0) {
         game.addScore(1)
     }
@@ -42,9 +38,8 @@ input.onButtonPressed(Button.A, () => {
 
 ## 4. Write the code that will display the string "LOGO DOWN" if the global variable called 'action' is equal to 1
 
-<br />
-
-```
+```blocks
+let action = Math.random(3)
 if (action == 1) {
     basic.showString("LOGO DOWN", 150)
 }
@@ -52,10 +47,9 @@ if (action == 1) {
 
 ## 5. Write the code that increments the score if the BBC micro:bit logo is tilted down when the global variable called 'action' is equal to 1
 
-<br />
-
-```
+```blocks
 input.onLogoDown(() => {
+    let action = Math.random(3)
     if (action == 1) {
         game.addScore(1)
     }
@@ -64,9 +58,8 @@ input.onLogoDown(() => {
 
 ## 6. Write the code that will display the string "SHAKE" if the global variable called 'action' is equal to 2
 
-<br />
-
-```
+```blocks
+let action = Math.random(3)
 if (action == 2) {
     basic.showString("SHAKE", 150)
 }
@@ -74,13 +67,11 @@ if (action == 2) {
 
 ## 7. Write the code that increments the score if the BBC micro:bit is shaken when the global variable called 'action' is equal to 2
 
-<br/>
-
-```
+```blocks
 input.onLogoDown(() => {
+    let action = Math.random(3)
     if (action == 1) {
         game.addScore(1)
     }
 })
 ```
-

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

@@ -2,8 +2,6 @@
 
 A game to catch eggs in a basket.
 
-### @video td/videos/catch-the-egg-game-0
-
 ## Topic
 
 Variables
@@ -11,6 +9,7 @@ Variables
 ## Quick Links
 
 * [activity](/lessons/catch-the-egg-game/activity)
+* [tutorial](/lessons/catch-the-egg-game/tutorial)
 * [quiz](/lessons/catch-the-egg-game/quiz)
 * [quiz answers](/lessons/catch-the-egg-game/quiz-answers)
 
@@ -20,18 +19,21 @@ Learn how to create a catch the egg game game with **plot**, `led->plot` , **unp
 
 ## Documentation
 
-* **variables** : [read more...](/reference/variables/var)
-* **forever** : [read more...](/reference/basic/forever)
-* **unplot** : [read more...](/reference/led/unplot)
-* **plot** : [read more...](/reference/led/plot)
-* **if** : [read more...](/reference/logic/if)
-* **acceleration** : [read more...](/reference/input/acceleration)
-* **math minimum number** : [read more...](/reference/math)
-* **math maximum number** : [read more...](/reference/math)
-* **math random number** : [read more...](/reference/math)
-* **math modulus** : [read more...](/reference/math)
-* **show number** : [read more...](/reference/basic/show-number)
-* **pause** : [read more...](/reference/basic/pause)
+```cards
+let x = 2;
+led.unplot(0, 0);
+basic.forever(() => {});
+x += 1;
+led.plot(0, 0);
+basic.pause(300);
+input.acceleration(Dimension.X);
+Math.min(0,0);
+Math.max(0,1);
+Math.random(5);
+game.addScore(1);
+game.score();
+game.removeLife(1);
+```
 
 ## Objectives
 

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

@@ -1,7 +1,5 @@
 # catch the egg game challenges
 
-Coding challenges for catch the egg game.
-
 ## Before we get started
 
 Your starting code should look like this:
@@ -110,8 +108,6 @@ basic.forever(() => {
 
 ### 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

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

@@ -0,0 +1,29 @@
+# catch the egg game tutorial
+
+### Rebuild the game!
+
+The blocks have been shuffled! Put them back together so that...
+* an egg LED  falls from the top of the screen, row by row.
+* a basket LED is on the bottom row and can be moved by using the accelerometer `X` data.
+* if the egg LED reaches the last row, reset the egg position to the first row.
+
+```shuffle
+let basketX = 2
+let eggX = 2
+let eggY = 0
+basic.forever(() => {
+    led.unplot(basketX, 4)
+    led.unplot(eggX, eggY)
+    eggY = eggY + 1
+    led.plot(eggX, eggY)
+    basic.pause(300)
+    let accX = input.acceleration(Dimension.X)
+    basketX = 2 + Math.min(2, Math.max(-2, accX / 200))
+    led.plot(basketX, 4)
+    if (eggY > 4) {
+        eggY = -1
+        eggX = Math.random(5)
+    }
+    basic.pause(300)
+})
+```

docs/lessons/challenges.md

@@ -1,6 +1,6 @@
 # blocks - challenges
 
-Extra stuff for the Block Editor - an introduction to GPIO #docs
+Extra stuff for the Block Editor - an introduction to GPIO
 
 ## Before we get started
 

docs/lessons/charting.md

@@ -7,7 +7,7 @@ Create a charting app for simulating and measuring the acceleration applied to t
 Acceleration
 
 ## Quick Links
-* [activity](/lessons/charting/acceleration) 
+* [activity](/lessons/charting/activity) 
 * [challenge](/lessons/charting/challenge) 
 * [quiz](/lessons/charting/quiz) 
 * [answers](/lessons/charting/quiz-answers)

docs/lessons/charting/activity.md

@@ -13,7 +13,6 @@ Let's measure `acceleration (mg)` in the "x" direction. Get the acceleration val
 
 ```blocks
 input.acceleration(Dimension.X)
-
 ```
 
 ### ~
@@ -41,7 +40,7 @@ Vigorously move the micro:bit in the micro:bit simulatator by moving the micro:b
 
 We want to chart the data collected by using a tool in Excel. 
 
-The final part of this experiment is opening and reviewing the data in the Excel CSV file. Simply click on the line beneath the simulator. A CSV file will be generated to display the data points collected by moving the micro:bit in the X direction. Then click or tap on the data Excel file that was downloaded to your local Downloads Folder. 
+The final part of this experiment is opening and reviewing the data in the Excel CSV file. Simply click on the line beneath the simulator. A CSV file will be generated to display the data points collected by moving the micro:bit in the X direction. Then click or tap on the data Excel file that was downloaded to your local ``Downloads`` Folder. 
 
 
 ### ~
@@ -57,29 +56,13 @@ Use the Recommended Charts command on the Insert tab to quickly create a chart t
 
 * Click Insert > Recommended Charts.
 
-![](/static/mb/chart1.png)
+![](/static/mb/lessons/chart1.png)
 
-* On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data.
-
-Click any chart type to see how your data will look in that format. 
-
-When you find the chart type that you want, click it, and then click OK. We want to select the chart called Line. A line chart is used to display trends over time. We will use the line chart because there are many data points over time. 
-
-Tip: If you don’t see a chart type that you want, click the All Charts tab to see all of the available chart types.
-
-![](/static/mb/chart_title.png)
-
-* Use the Chart Elements, Chart Styles, and Chart Filters buttons next to the upper-right corner of the chart to add chart elements like axis titles or data labels, to customize the look of your chart
-
-![](/static/mb/elements_styles_filters.png)
-
-* Connect a micro:bit to your computer using your USB cable; compile; and repeat this experiment by moving the micro:bit in the "x" direction. Then collect and chart the data on Excel. 
-* Review and analyze the actual micro:bit device data on Excel
-* Display acceleration with y or z using plot bar graph by changing acceleration from "x" to "y" or "z" 
+* On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data. Pick the **scatter plot**.
 
 ### ~avatar avatar
 
-Excellent, you're ready to continue with the [challenges](/lessons/charting/acceleration-challenge)
+Excellent, you're ready to continue with the [challenges](/lessons/charting/challenge)
 
 ### ~
 

docs/lessons/charting/challenge.md

@@ -2,7 +2,8 @@
 
 ### ~avatar avatar 
 
-Welcome! The activity will teach you how to use the acceleration of the 1st micro:bit and to visualize the acceleration on the 2nd micro:bit. Let's get started!
+Welcome! The activity will teach you how to use the acceleration of the 1st micro:bit and to visualize the acceleration on the 2nd micro:bit. 
+Let's get started!
 
 ### ~
 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.
@@ -52,7 +53,7 @@ Notice that moving the micro:bit the farthest direction in the x direction will
 NOTE: The colors of the charts reflect the color of the micro:bit simulator. In this instance, the micro:bits are blue and green. So the colors of the line graphs reflect the colors of the micro:bit
  
  ### ~
-After running this simulatation several seconds by moving the micro:bit side to side in the x direction, you are ready to graph or chart the accceleration of the micro:bit.  We want a printout of our acceleration on Excel. We will graph the fluctuating acceleration of the simulation experiment. 
+After running this simulation several seconds by moving the micro:bit side to side in the x direction, you are ready to graph or chart the accceleration of the micro:bit.  We want a printout of our acceleration on Excel. We will graph the fluctuating acceleration of the simulation experiment. 
 
 ![](/static/mb/acc2.png)
 
@@ -67,15 +68,9 @@ Use the Recommended Charts command on the Insert tab to quickly create a chart t
 
 * Click Insert > Recommended Charts.
 
-![](/static/mb/chart1.png)
+![](/static/mb/lessons/chart1.png)
 
-* On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data.
-
-Click any chart type to see how your data will look in that format. 
-
-When you find the chart type that you want, click it, and then click OK. We want to select the chart called Line. A line chart is used to display trends over time. We will use the line chart because there are many data points over time. 
-
-Tip: If you don’t see a chart type that you want, click the All Charts tab to see all of the available chart types.
+* On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data. Pick the **scatter plot**.
 
 ![](/static/mb/chart_title.png)
 
@@ -91,4 +86,3 @@ Have fun reviewing your simulation and analyze the acceleration by chart the Exc
 * The first person and second person take turns tilting the micro:bit in the "x" direction while the other player charts the data on the micro:bit!
 * Review and analyze the actual micro:bit device acceleration data on Excel
 * Display acceleration with y or z using plot bar graph by changing acceleration from "x" to "y" or "z" 
-

docs/lessons/classic-beatbox/challenges.md

@@ -17,7 +17,7 @@ input.onPinPressed(TouchPin.P1, () => {
 })
 ```
 
-**Challenge 1**
+### Challenge 1
 
 Let's include a second sound `on pin pressed` *P2*. To do this, you need to add the same blocks as the banana keyboard activity. However, you must change alter `on pin pressed` from P1 to P2. Additionally, you must *decrease* the frequency of the variable "sound" by 25. Modify your code so that your code looks like this
 
@@ -42,7 +42,7 @@ input.onPinPressed(TouchPin.P2, () => {
 
 * click *run* to see if the code works as expected.
 
-**Challenge 2**
+### Challenge 2
 
 Finally, we want images to be displayed with sounds `on pin pressed`. Add `show LEDs` blocks under `on pin pressed` P1 and P2.
 

docs/lessons/compass.md

@@ -2,8 +2,6 @@
 
 create a die on the BBC micro:bit.
 
-### @video td/videos/compass-0
-
 ## Topic
 
 If (Conditionals)

docs/lessons/counter.md

@@ -2,8 +2,6 @@
 
 Learn how to create a counter with with on button pressed.
 
-### @video td/videos/counter-0
-
 ## Topic
 
 Variables

docs/lessons/counter/activity.md

@@ -4,8 +4,6 @@ Display a number with a variable.
 
 ### ~avatar avatar
 
-### @video td/videos/counter-0
-
 Welcome! This tutorial will teach you how to make a counter that increments when button A is pressed. Let's get started!
 
 ### ~

docs/lessons/counter/challenges.md

@@ -16,8 +16,6 @@ input.onButtonPressed(Button.A, () => {
 
 ### Challenge 1
 
-### @video td/videos/counter-1-2
-
 Let's add the code to `count` when `B` is pressed. Add an event handler with `on button pressed(B)` then add the code to `count`.
 
 
@@ -33,7 +31,6 @@ input.onButtonPressed(Button.B, () => {
 })
 ```
 
-
 ### Challenge 3
 
 Now let's try to reset the counter when the micro:bit is shaken. You will need to register an event handler with `on shake`.

docs/lessons/dice-roll.md

@@ -1,8 +1,6 @@
-# die roll lesson
+# dice roll lesson
 
-create a die on the BBC micro:bit.
-
-### @video td/videos/die-roll-0
+Create a  dice on the BBC micro:bit.
 
 ## Topic
 
@@ -10,10 +8,10 @@ If (Conditionals)
 
 ## Quick Links
 
-* [activity](/lessons/die-roll/activity)
-* [challenges](/lessons/die-roll/challenges)
-* [quiz](/lessons/die-roll/quiz)
-* [quiz answers](/lessons/die-roll/quiz-answers)
+* [activity](/lessons/dice-roll/activity)
+* [challenges](/lessons/dice-roll/challenges)
+* [quiz](/lessons/dice-roll/quiz)
+* [quiz answers](/lessons/dice-roll/quiz-answers)
 
 ## Prior learning/place of lesson in scheme of work
 

docs/lessons/dice-roll/activity.md

@@ -1,12 +1,10 @@
-# die roll activity
+# dice roll activity
 
-Create a die on the micro:bit
+Create a dice on the micro:bit
 
 ### ~avatar avatar
 
-### @video td/videos/die-roll-0
-
-Welcome! This tutorial will help you create a die. Let's get started!
+Welcome! This tutorial will help you create a dice. Let's get started!
 
 ### ~
 
@@ -19,7 +17,7 @@ input.onGesture(Gesture.Shake, () => {
 })
 ```
 
-We need to show a random value from 1 to 6 on our die. So let's make a local variable called **roll**.
+We need to show a random value from 1 to 6 on our dice. So let's make a local variable called **roll**.
 
 ```blocks
 input.onGesture(Gesture.Shake, () => {
@@ -27,7 +25,7 @@ input.onGesture(Gesture.Shake, () => {
 })
 ```
 
-We need a condition for if **roll** is 5. We will show a `6` if **roll** is 5 because **roll** has a range from 0 to 5. We can use `show LEDs` to display the side of a die that shows 6.
+We need a condition for if **roll** is 5. We will show a `6` if **roll** is 5 because **roll** has a range from 0 to 5. We can use `show LEDs` to display the side of a dice that shows 6.
 
 
 ```blocks
@@ -45,7 +43,7 @@ input.onGesture(Gesture.Shake, () => {
 ```
 
 
-Let's use an `else if` condition for if **roll** is 4. If **roll** is 4 we can show 5 dots on the die.
+Let's use an `else if` condition for if **roll** is 4. If **roll** is 4 we can show 5 dots on the dice.
 
 
 ```blocks
@@ -72,7 +70,7 @@ input.onGesture(Gesture.Shake, ()=> {
 ```
 
 
-Now we need to repeat the same steps for if **roll** is 3. If **roll** is 3 we will show `4` on the die.
+Now we need to repeat the same steps for if **roll** is 3. If **roll** is 3 we will show `4` on the dice.
 
 
 ```blocks
@@ -106,7 +104,7 @@ input.onGesture(Gesture.Shake, () => {
 ```
 
 
-Let's also repeat these steps to show the 3, 2, and 1 on the die. We are almost done with our die!
+Let's also repeat these steps to show the 3, 2, and 1 on the dice. We are almost done with our dice!
 
 ```blocks 
 input.onGesture(Gesture.Shake, () => {
@@ -165,7 +163,7 @@ input.onGesture(Gesture.Shake, () => {
 
 ### ~avatar avatar
 
-Excellent, you're ready to continue with the [challenges](/lessons/die-roll/challenges)!
+Excellent, you're ready to continue with the [challenges](/lessons/dice-roll/challenges)!
 
 ### ~
 

docs/lessons/dice-roll/challenges.md

@@ -1,10 +1,10 @@
-# die roll challenges
+# dice roll challenges
 
-Create a die on the micro:bit. 
+Create a dice on the micro:bit. 
 
 ## Before we get started
 
-Complete the following [guided tutorial](/lessons/die-roll/activity), your code should look like this:
+Complete the following [guided tutorial](/lessons/dice-roll/activity), your code should look like this:
 
 ```blocks 
 input.onGesture(Gesture.Shake, () => {
@@ -62,7 +62,7 @@ input.onGesture(Gesture.Shake, () => {
 
 ### Challenge 1
 
-Modify the line of code with `pick random` so that only number 1-4 can appear on the die.
+Modify the line of code with `pick random` so that only number 1-4 can appear on the dice.
 
 
 ```blocks 
@@ -121,7 +121,7 @@ input.onGesture(Gesture.Shake, () => {
 
 ### Challenge 2
 
-Let's make a trick die! Modify the line of code with `pick random` so that only numbers 3-6 can appear on the die. Also note that we need to ensure `roll = 0` when only 1 dot is shown on the BBC micro:bit.
+Let's make a trick dice! Modify the line of code with `pick random` so that only numbers 3-6 can appear on the dice. Also note that we need to ensure `roll = 0` when only 1 dot is shown on the BBC micro:bit.
 
 ```blocks 
 input.onGesture(Gesture.Shake, () => {

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

@@ -1,8 +1,8 @@
-# die roll quiz answers
+# dice roll quiz answers
 
-Create a die when the BBC micro:bit is shaken 
+Create a dice when the BBC micro:bit is shaken 
 
-These are the answers to the [die roll quiz](/lessons/die-roll/quiz).
+These are the answers to the [dice roll quiz](/lessons/dice-roll/quiz).
 
 ## 1. Create a variable named 'roll' that will be randomly assigned to a number between 0 and 5.
 

docs/lessons/dice-roll/quiz.md

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

docs/lessons/digi-yoyo.md

@@ -1,8 +1,6 @@
 # digi yoyo lesson
 
-create a counter with a while loop.
-
-### @video td/videos/digi-yoyo-0
+Create a counter with a while loop.
 
 ## Topic
 

docs/lessons/digi-yoyo/activity.md

@@ -4,8 +4,6 @@ Create a counter with a while loop.
 
 ### ~avatar avatar
 
-### @video td/videos/digi-yoyo-0
-
 Welcome! This tutorial will teach how to create a counter with a while loop. Let's get started!
 
 ### ~

docs/lessons/digi-yoyo/challenges.md

@@ -40,8 +40,6 @@ while (count > 0) {
 
 ### Challenge 2
 
-### @video td/videos/digi-yoyo-1-2
-
 Inside of the while loop, let's add `pause->(1000)` so that we have a pause between each number as it's counting down. Also, let's show `count`!
 
 

docs/lessons/flashing-heart.md

@@ -2,8 +2,6 @@
 
 Learn how to create LED images with a global variable.
 
-### @video td/videos/flashing-heart-0
-
 ## Topic
 
 Pause

docs/lessons/flashing-heart/activity.md

@@ -4,8 +4,6 @@ Control images with a variable.
 
 ### ~avatar avatar
 
-### @video td/videos/flashing-heart-0
-
 In this activity, you will learn how to blink an image on the LED screen.
 
 ### ~

docs/lessons/flashing-heart/challenges.md

@@ -25,8 +25,6 @@ basic.forever(() => {
 
 ### Challenge 1
 
-### @video td/videos/flashing-heart-1
-
 Let's plot a different image. Let's display a broken heart!
 
 To do this, you need to add a block between the last line and the end loop. Add a `show LEDs` block and then add a `pause` of 500 milliseconds.
@@ -60,8 +58,6 @@ basic.forever(() => {
 
 ### Challenge 2
 
-### @video td/videos/flashing-heart-2
-
 Now let's alternate flashing the heart and the broken heart. To do this, we need to add a `clear screen` block and then add a `pause` block of 500 milliseconds under the new code we added in Challenge 1.
 
 

docs/lessons/game-counter.md

@@ -2,8 +2,6 @@
 
 Learn how to create a counter with with on button pressed.
 
-### @video td/videos/counter-0
-
 ## Topic
 
 Game Library

docs/lessons/game-counter/activity.md

@@ -1,13 +1,5 @@
 # game counter activity
 
-Turn an LED on and off with forever loop
-
-### ~avatar avatar
-
-### @video td/videos/counter-0
-
-### ~
-
 Have you ever tried to create a game counter? The concept is fairly simply: increase the game `score` with `on button pressed` .
 
 Let's start by adding `on button (A) pressed` will run each time the user presses A. Let's add a line of code that increments `score` by `1`.

docs/lessons/game-counter/challenges.md

@@ -15,8 +15,6 @@ input.onButtonPressed(Button.A, () => {
 
 ### Challenge 1
 
-### @video td/videos/counter-1-2
-
 Let's add the code to `score` when `B` is pressed. Add an event handler with `on button (B) pressed` then add the code to `score`.
 
 

docs/lessons/game-of-chance.md

@@ -1,6 +1,6 @@
 # game of chance blocks lesson
 
-create an answering machine on the BBC micro:bit #docs
+create an answering machine on the BBC micro:bit
 
 ## Topic
 

docs/lessons/game-of-chance/challenges.md

@@ -42,7 +42,7 @@ input.onButtonPressed(Button.B, () => {
 
 * `Run` the code to see if it works as expected.
 
-**Challenge 3**
+### Challenge 3
 
 When you are asked a yes or no question, do you always say yes or no? Add a condition for `on shake` that displays `TRY AGAIN`.
 

docs/lessons/glowing-pendulum.md

@@ -9,6 +9,7 @@ Acceleration
 ## Quick Links
 
 * [activity](/lessons/glowing-pendulum/activity)
+* [tutorial](/lessons/glowing-pendulum/tutorial)
 * [challenges](/lessons/glowing-pendulum/challenges)
 * [quiz](/lessons/glowing-pendulum/quiz)
 * [quiz answers](/lessons/glowing-pendulum/quiz-answers)

docs/lessons/glowing-pendulum/activity.md

@@ -4,10 +4,29 @@ Construct a pendulum that glows using acceleration.
 
 Welcome! This activity will teach how to construct a pendulum that glows using acceleration. Let's get started!
 
+Turn on all the LEDs.
+
+```blocks
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
+```
+
 Create a **forever** loop that will constantly display the appropriate brightness on the LED display.
 
 
 ```blocks
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
 basic.forever(() => {
     
 })
@@ -16,6 +35,13 @@ basic.forever(() => {
 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.
 
 ```blocks
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
 basic.forever(() => {
     let acceleration = input.acceleration(Dimension.Y);
 });
@@ -25,9 +51,15 @@ Since the micro:bit will be swinging back and forth, the acceleration will only
 
 
 ```blocks
-let acceleration = 0;
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
 basic.forever(() => {
-    acceleration = input.acceleration(Dimension.Y);
+    let acceleration = input.acceleration(Dimension.Y);
     acceleration = Math.abs(acceleration)
 });
 ```
@@ -35,6 +67,13 @@ basic.forever(() => {
 The function `acceleration(y)` returns a number between 0 and 1024. We want to use this value for the brightness of the micro:bit, but the `set brightness()` only accepts a value between 0 and 256. Thus, we need to divide the acceleration by 4 to ensure we will be in the appropriate range.
 
 ```blocks
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
 basic.forever(() => {
     let acceleration = input.acceleration(Dimension.Y);
     acceleration = Math.abs(acceleration);
@@ -46,37 +85,19 @@ basic.forever(() => {
 Now let's use our acceleration value to set the brightness on the micro:bit.
 
 ```blocks
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
 basic.forever(() => {
     let acceleration = input.acceleration(Dimension.Y);
     acceleration = Math.abs(acceleration);
     acceleration = acceleration / 4;
     led.setBrightness(acceleration)
 });
-
-
-
-```
-
-
-Let's show what the brightness of the micro:bit is by turning all the LEDs on!
-
-```blocks
-
-basic.forever(() => {
-    let acceleration = input.acceleration(Dimension.Y);
-    acceleration = Math.abs(acceleration);
-    acceleration = acceleration / 4;
-    led.setBrightness(acceleration)
-    basic.showLeds(`
-        # # # # #
-        # # # # #
-        # # # # #
-        # # # # #
-        # # # # #
-        `)
-});
-
-
 ```
 
 ### ~avatar avatar

docs/lessons/glowing-pendulum/challenges.md

@@ -24,13 +24,13 @@ basic.forever(() => {
 
 ```
 
-**Challenge 1**
+### Challenge 1
 
 ![](/static/mb/lessons/glowing-pendulum-0.jpg)
 
 Hold the micro:bit in your hand in a dark room. Move the micro:bit like a pendulum and produce a slow image that captures the pattern of the micro:bit LEDs.
 
-**Challenge 2**
+### Challenge 2
 
 Replace "y" in `acceleration(y)` with "x" or "z". Changing the axis will cause the micro:bit to measure the force in a different direction. What differences in the resulting pattern does this replacement make?
 

docs/lessons/glowing-pendulum/tutorial.md

@@ -0,0 +1,29 @@
+# glowing pendulum block tutorial
+
+The glowing pendulum changes the screen brightness based on the acceleration measured on the BBC micro:bit.
+
+### Rebuild the game!
+
+The blocks have been shuffled! Put them back together so that...
+* all LEDs are turned on
+* the BBC micro:bit repeats code **forever** that
+  * reads the acceleration along the ``y`` axis,
+  * calculate the absolute value of the acceleration
+  * scales down the acceleration value by a factor of `4`
+  * uses the scaled value to set the screen **brightness**
+
+```blocks
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
+basic.forever(() => {
+    let acceleration = input.acceleration(Dimension.Y);
+    acceleration = Math.abs(acceleration);
+    acceleration = acceleration / 4;
+    led.setBrightness(acceleration)
+});
+```

docs/lessons/graphics.md

@@ -1,6 +1,6 @@
 # blocks - rendering graphics
 
-An introduction to graphics for the Block Editor. #docs
+An introduction to graphics for the Block Editor.
 
 ## Before we get started
 

docs/lessons/guess-the-number.md

@@ -2,8 +2,6 @@
 
 Learn to create a random number with input from button A.
 
-### @video td/videos/guess-the-number-0
-
 ## Topic
 
 Math - Pick Random
@@ -11,6 +9,7 @@ Math - Pick Random
 ## Quick links
 
 * [activity](/lessons/guess-the-number/activity)
+* [tutorial](/lessons/guess-the-number/tutorial)
 * [challenges](/lessons/guess-the-number/challenges)
 * [quiz](/lessons/guess-the-number/quiz)
 * [quiz answers](/lessons/guess-the-number/quiz-answers)

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

@@ -4,8 +4,6 @@ Guess the number with math random.
 
 ### ~avatar avatar
 
-### @video td/videos/guess-the-number-0
-
 Welcome! This tutorial will help you create a guess the number game! Let's get started!
 
 ### ~
@@ -19,12 +17,11 @@ input.onButtonPressed(Button.A, () => {
 
 ```
 
-Create a local variable of type number `x` and set it to a random number using `pick random`. `pick random` 9 generates a random number between `0` and `09`.
-
+Create a local variable of type number `x` and set it to a random number using `pick random`. `pick random` 9 generates a random number between `0` and `9`.
 
 ```blocks
 input.onButtonPressed(Button.A, () => {
-    let x = Math.random(9)
+    let x = Math.random(10)
 })
 
 ```
@@ -34,7 +31,7 @@ Show the random number on the screen.
 
 ```blocks
 input.onButtonPressed(Button.A, () => {
-    let x = Math.random(9)
+    let x = Math.random(10)
     basic.showNumber(x)
 })
 

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

@@ -15,8 +15,6 @@ input.onButtonPressed(Button.A, () => {
 
 ### Challenge 1
 
-### @video td/videos/guess-the-number-2
-
 When button `B` is pressed, we want to clear the screen. This will make it so users can play your game over and over again! Add an event handler to handle this case.
 
 ```blocks

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

@@ -0,0 +1,23 @@
+# guess the number tutorial
+
+### ~avatar avatar
+
+This tutorial will help you create a guess the number game! Let's get started!
+
+### ~
+
+### Rebuild the game!
+
+The blocks have been shuffled! Put them back together so that...
+* when the user presses button ``A``,
+  * generate a random number
+  * show the number on screen
+
+
+```shuffle
+input.onButtonPressed(Button.A, () => {
+    let x = Math.random(10)
+    basic.showNumber(x)
+})
+```
+

docs/lessons/looper.md

@@ -2,8 +2,6 @@
 
 Learn to control blinking LEDs.
 
-### @video td/videos/looper-0
-
 ## Topic
 
 For Loop

docs/lessons/looper/activity.md

@@ -1,13 +1,5 @@
 # looper blocks activity
 
-Display a series of numbers with a for loop. 
-
-### ~avatar avatar
-
-### @video td/videos/looper-0
-
-### ~
-
 Welcome! This activity will teach how to display a series of numbers for a for loop. Let's get started!
 
 Let's create a for loop where `0` is the loop's starting value, `i` is the index variable, and `5` is the ending value. The index variable `i` starts at 0 and increases by 1 each time through the loop. The loop ends when `i = 5`.

docs/lessons/looper/challenges.md

@@ -20,8 +20,6 @@ for (let i = 0; i < 6; i++) {
 
 ### Challenge 1
 
-### @video td/videos/looper-1
-
 What if we want to count up to lucky number 7 instead? Let's do that by changing the ending value to `7` instead of `5`.
 
 
@@ -37,8 +35,6 @@ for (let i = 0; i < 8; i++) {
 
 ### Challenge 2
 
-### @video td/videos/looper-2
-
 What about 9? Let's do that by changing the ending value to `9`.
 
 ```blocks
@@ -55,8 +51,6 @@ for (let i = 0; i < 10; i++) {
 
 ### Challenge 3
 
-### @video td/videos/looper-3
-
 Now let's start counting from `3` instead! Our for loop will always start at `0` so we simply add `3` to the `i` variable when passing it to `show number`.
 
 ```blocks
@@ -72,8 +66,6 @@ Run it on the simulator!
 
 ### Challenge 4
 
-### @video td/videos/looper-4
-
 Now, let's **count down from 9**. Change the line `show number(i + 2, 150)` to `show number(9 - i, 150)`.
 
 ```blocks

docs/lessons/loops.md

@@ -1,6 +1,6 @@
 # blocks - loops
 
-An introduction to Loops for the Block Editor. #docs
+An introduction to Loops for the Block Editor.
 
 We may want to handle the user’s input multiple times or remain waiting for their input for a long time. We use loops to make sure that our code runs multiple times. These can be found in the **Loops** drawer.
 

docs/lessons/love-meter.md

@@ -1,8 +1,6 @@
 # love meter blocks lesson
 
-create a love meter with the BBC micro:bit.
-
-### @video td/videos/love-meter-0
+Create a love meter with the BBC micro:bit.
 
 ## Topic
 

docs/lessons/love-meter/activity.md

@@ -4,8 +4,6 @@ Create a love meter with the micro:bit
 
 ### ~avatar avatar
 
-### @video td/videos/love-meter-0
-
 Welcome! This activity will help you create a love meter with the micro:bit. Let's get started!
 
 ### ~

docs/lessons/love-meter/challenges.md

@@ -45,8 +45,6 @@ input.onPinPressed(TouchPin.P0, () => {
 
 ### Challenge 3
 
-### @video td/videos/love-meter-3
-
 **If** the rating is between 4 and 7, display the text "MEDIOCRE!" **else** display the text "MATCHED!"
 
 ```blocks

docs/lessons/lucky-7.md

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

docs/lessons/lucky-7/activity.md

@@ -4,8 +4,6 @@ Show a number on the LED screen.
 
 ### ~avatar avatar
 
-### @video td/videos/lucky-7-0
-
 Let's learn how to show the lucky number 7 on the LED screen.
 
 ### ~

docs/lessons/lucky-7/challenges.md

@@ -21,8 +21,6 @@ basic.pause(500)
 
 ### Challenge 2
 
-### @video td/videos/lucky-7-1-2
-
 What about other multiples of 7? Let's display the next multiple of 7 on the screen!
 
 ```blocks
@@ -35,5 +33,5 @@ basic.showNumber(14)
 
 ### Challenge 3
 
-Keep displaying multiples of 7 such as 21 and 28, but don't forget to add pauses between the numbers!
+Keep displaying multiples of 7 such as 21 and 28...
 

docs/lessons/lucky-7/tutorial.md

@@ -0,0 +1,31 @@
+# lucky 7 blocks challenges
+
+Coding challenges for lucky 7.
+
+###~ Avatar
+
+### @video td/videos/lucky-7-1-2
+
+### Rebuild the game!
+
+The blocks have been shuffled! Put them back together so that…
+* The blocks should be multiples of 7 and a pause between the numbers
+
+```shuffle
+basic.showNumber(7)
+basic.pause(500)
+basic.showNumber(14)
+```
+
+### Hints and tips
+
+Cut out these documentation cards to help you!
+
+```cards
+basic.showNumber()
+basic.pause()
+```
+
+* Run the code to see if it works as expected.
+
+

docs/lessons/magic-8.md

@@ -9,6 +9,7 @@ If (Conditionals)
 ## Quick Links
 
 * [activity](/lessons/magic-8/activity)
+* [tutorial](/lessons/magic-8/tutorial)
 * [challenges](/lessons/magic-8/challenges)
 * [quiz](/lessons/magic-8/quiz)
 * [quiz answers](/lessons/magic-8/quiz-answers)

docs/lessons/magic-8/activity.md

@@ -1,8 +1,6 @@
 # magic 8 activity
 
-A fortune teller game on the micro:bit 
-
-Welcome! This tutorial will help you create a magic 8 ball on the micro:bit. Let's get started!
+Welcome! This activity will help you create a magic 8 ball on the micro:bit. Let's get started!
 
 Show a string to instruct the user how to play Magic 8! The magic 8 ball can only answer true or false questions.
 
@@ -32,16 +30,13 @@ input.onGesture(Gesture.Shake, () => {
 Create a variable of type number called **randomNumber**. Set **randomNumber** to a random number with a limit of 2. Remember the random function in the math library, picks a random number from 0 to the limit, but not including the limit unless it is 0.
 
 ```blocks
-
 basic.showString("ASK A QUESTION")
 basic.showNumber(8)
 input.onGesture(Gesture.Shake, () => {
     basic.clearScreen()
-    let randomNumber = Math.random(2)
+    let randomNumber = Math.random(3)
 
 });
-
-
 ```
 
 Create an if statement for the condition `if randomNumber = 2`. If **randomNumber** is 2, display the string 'Yes'
@@ -52,7 +47,7 @@ basic.showString("ASK A QUESTION")
 basic.showNumber(8)
 input.onGesture(Gesture.Shake, () =>  {
     basic.clearScreen();
-    let randomNumber = Math.random(2);
+    let randomNumber = Math.random(3);
     if (randomNumber == 2) {
         basic.showString("YES");
     }
@@ -68,7 +63,7 @@ basic.showString("ASK A QUESTION")
 basic.showNumber(8)
 input.onGesture(Gesture.Shake, () => {
     basic.clearScreen()
-    let randomNumber = Math.random(2)
+    let randomNumber = Math.random(3)
     if (randomNumber == 2) {
         basic.showString("YES")
     } else if (randomNumber == 1) {
@@ -84,7 +79,7 @@ basic.showString("ASK A QUESTION")
 basic.showNumber(8)
 input.onGesture(Gesture.Shake, () =>  {
     basic.clearScreen()
-    let randomNumber = Math.random(2)
+    let randomNumber = Math.random(3)
     if (randomNumber == 2) {
         basic.showString("YES")
     } else if (randomNumber == 1) {
@@ -106,14 +101,13 @@ basic.showString("ASK A QUESTION")
 basic.showNumber(8)
 input.onGesture(Gesture.Shake, () =>  {
     basic.clearScreen()
-    let randomNumber = Math.random(2)
+    let randomNumber = Math.random(3)
     if (randomNumber == 2) {
         basic.showString("YES")
     } else if (randomNumber == 1) {
         basic.showString("NO")
     } else {
         basic.showString("I DON'T KNOW")
-
     }
     basic.showNumber(8)
 

docs/lessons/magic-8/challenges.md

@@ -26,7 +26,7 @@ input.onGesture(Gesture.Shake, () =>  {
 ```
 
 
-**Challenge 1**
+### Challenge 1
 
 Now let's increase the number of responses the magic 8 ball can give. How about 5 responses instead? Let's change the limit of `pick random` to  4.
 
@@ -49,7 +49,7 @@ input.onGesture(Gesture.Shake, () =>  {
 })
 ```
 
-**Challenge 2**
+### Challenge 2
 
 Now have the magic 8 ball respond "Try again" if **randomNumber** is 3.
 
@@ -73,7 +73,7 @@ input.onGesture(Gesture.Shake, () => {
 })
 ```
 
-**Challenge 3**
+### Challenge 3
 
 Now what about if **randomNumber** is 4? Let's have the magic 8 ball respond "Definitely!".
 

docs/lessons/magic-8/tutorial.md

@@ -0,0 +1,27 @@
+# Magic 8 tutorial
+
+Show a string to instruct the user how to play Magic 8! The magic 8 ball can only answer questions with "YES", "NO", or "MAYBE"...
+
+### Rebuild the game!
+
+The blocks have been shuffled! Put them back together so that...
+* show "ASK A QUESTION" on the screen
+* when the micro:bit is shaken,
+  * generate a random number between 0 and 2.
+  * if the number is `2`, show "YES"
+  * if the number is `1`, show "NO"
+  * otherwise show "MAYBE"...
+
+```shuffle
+basic.showString("ASK A QUESTION")
+input.onGesture(Gesture.Shake, () =>  {
+    let randomNumber = Math.random(3)
+    if (randomNumber == 2) {
+        basic.showString("YES")
+    } else if (randomNumber == 1) {
+        basic.showString("NO")
+    } else {
+        basic.showString("MAYBE")
+    }
+})
+```

docs/lessons/magic-logo.md

@@ -2,7 +2,7 @@
 
 show an image that points up when the logo is up.
 
-### @video td/videos/magic-logo-0
+
 
 ## Topic
 

docs/lessons/magic-logo/activity.md

@@ -4,8 +4,6 @@ Show an image that points up when the logo is up.
 
 ### ~avatar avatar
 
-### @video td/videos/magic-logo-0
-
 Welcome! This tutorial will help you display an arrow pointing toward the logo! Let's get started.
 
 ### ~
@@ -30,8 +28,6 @@ input.onGesture(Gesture.LogoUp, () => {
         . . # . .
         `)
 })
-
-
 ```
 
 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

@@ -24,8 +24,6 @@ input.onLogoUp(() => {
 
 How about when the logo is down? We should display an arrow pointing downward!
 
-### @video td/videos/magic-logo-1-2
-
 ```blocks
 input.onLogoUp(() => {
     basic.showLeds(`

docs/lessons/night-light.md

@@ -2,8 +2,6 @@
 
 change the brightness of the BBC micro:bit.
 
-### @video td/videos/night-light-0
-
 ## Topic
 
 Set Brightness

docs/lessons/night-light/activity.md

@@ -4,8 +4,6 @@ Change the brightness of the micro:bit.
 
 ### ~avatar avatar
 
-### @video td/videos/night-light-0
-
 Welcome! This tutorial will teach you how to change the brightness of the micro:bit. Let's get started!
 
 ### ~

docs/lessons/night-light/challenges.md

@@ -23,7 +23,7 @@ input.onButtonPressed(Button.A, () => {
 ```
 ### Challenge 1
 
-### @video td/videos/night-light-2
+
 
 What if we want to turn off all the LEDs? Let's do this by setting the brightness to `0` when button `B` is pressed. Add an event handler with `on button pressed(B)` add `set brightness(0)` to turn off the LEDs.
 
@@ -46,7 +46,7 @@ input.onButtonPressed(Button.B, () => {
 ```
 
 
-**Challenge 3**
+### Challenge 3
 
 Add an event handler with `on shake` to change the LED brightness back to a `255`.
 

docs/lessons/night-light/offset-image/activity.md

@@ -1,6 +1,6 @@
 # offset image challenges
 
-Coding challenges for the offset image tutorial. #docs
+Coding challenges for the offset image tutorial.
 
 ## Before we get started
 
@@ -55,7 +55,7 @@ input.onButtonPressed(Button.B, () => {
 
 ### Challenge 2
 
-### @video td/videos/offset-image-2
+
 
 Now we want to make sure that the button does not go off the screen to the right. Add a new line that checks to see if offset = 5 after button `A` is pressed.
 
@@ -88,7 +88,7 @@ input.onButtonPressed(Button.B, () => {
 
 * Run the code to see if it works as expected.
 
-**Challenge 3**
+### Challenge 3
 
 Now make sure the image does not go off the left side and if it does, prompt the user to push button `A`.
 

docs/lessons/prank-wifi.md

@@ -1,8 +1,6 @@
 # prank wifi lesson
 
-create a fake wifi app to trick your friends.
-
-create a fake wifi app to trick your friends
+Create a fake wifi app to trick your friends
 
 * [activity](/lessons/prank-wifi/activity)
 * [quiz](/lessons/prank-wifi/quiz)

docs/lessons/prank-wifi/activity.md

@@ -1,6 +1,6 @@
 # prank wifi challenges
 
-create a fake wifi app to trick your friends. #docs
+create a fake wifi app to trick your friends.
 
 ## Before we get started
 
@@ -42,7 +42,7 @@ basic.forever(() => {
 
 ```
 
-**Challenge 1**
+### Challenge 1
 
 What if wanted to show the maximum connectivity of wifi instead of just 1, 3, or 4 bars?
 
@@ -86,7 +86,7 @@ basic.forever(() => {
 })
 ```
 
-**Challenge 2**
+### Challenge 2
 
 Let's add an **IF** at the bottom of your code that checks to see if `sum >= to 1200` **and** if `sum <1400`
 
@@ -135,7 +135,7 @@ basic.forever(() => {
 })
 ```
 
-**Challenge 3**
+### 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 `showLeds()`.
 

docs/lessons/rock-paper-scissors.md

@@ -1,8 +1,6 @@
 # rock paper scissors lesson
 
-a game against the BBC micro:bit.
-
-### @video td/videos/rock-paper-scissors-0
+A game against the BBC micro:bit.
 
 ## Topic
 

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

@@ -4,7 +4,7 @@ A classic game against the micro:bit.
 
 ### ~avatar avatar
 
-### @video td/videos/rock-paper-scissors-0
+
 
 Welcome! This tutorial will help you create a game of rock paper scissors with the micro:bit. Let's get started!
 

docs/lessons/rotation-animation.md

@@ -20,6 +20,7 @@ Learn how to create images that look like a rotating animation by using a while
 ## Documentation
 
 ```cards
+while (true) {}
 let x = 0
 input.onButtonPressed(Button.A, () => {})
 basic.showLeds(`
@@ -30,7 +31,6 @@ basic.showLeds(`
     . . . . .
     `)
 basic.pause(100)
-while (true) {}
 ```
 
 ## Objectives

docs/lessons/rotation-animation/challenges.md

@@ -93,7 +93,7 @@ input.onButtonPressed(Button.A, () => {
 
 ### Challenge 2
 
-### @video td/videos/rotation-animation-1-and-2
+
 
 Now that we have the on button pressed condition, let's make the animation stop rotating by setting the rotating global variable to false when button `A` is pressed.
 

docs/lessons/screen-wipe.md

@@ -1,8 +1,6 @@
 # screen wipe blocks lesson
 
-clear the screen by pressing button "A".
-
-### @video td/videos/screen-wipe-0
+Clear the screen by pressing button "A".
 
 ## Topic
 

docs/lessons/screen-wipe/activity.md

@@ -4,7 +4,7 @@ Clear the screen by pressing buttons on the micro:bit
 
 ### ~avatar avatar
 
-### @video td/videos/screen-wipe-0
+
 
 This activity will teach how to clear the screen by pressing button A on the micro:bit.
 

docs/lessons/screen-wipe/challenges.md

@@ -4,7 +4,7 @@ Coding challenges for screen wipe.
 
 ## Before we get started
 
-Complete the [screen wipe](/lessons/screen-wipe) activity and your code will look like this:
+Complete the [screen wipe](/lessons/screen-wipe/activity) activity and your code will look like this:
 
 ```blocks
 basic.showLeds(`
@@ -41,7 +41,7 @@ input.onButtonPressed(Button.A, () => {
 
 ```
 
-**Challenge 1**
+### Challenge 1
 
 Create an event handler for Button B.
 
@@ -83,9 +83,9 @@ input.onButtonPressed(Button.B, () => {
 
 ```
 
-**Challenge 2**
+### Challenge 2
+
 
-### @video td/videos/screen-wipe-2
 
 Replay the animation when the "B" button is pressed placing the `show LEDs` block on the canvas.
 
@@ -155,7 +155,7 @@ basic.showLeds(`
 ```
 
 
-**Challenge 3**
+### Challenge 3
 
 Show an animation that scrolls back up when you press button "B".
 

docs/lessons/seismograph.md

@@ -9,7 +9,7 @@ Acceleration & Analog Read Pin
 ## Quick Links
 
 * [activity](/lessons/seismograph/activity)
-* [challenge](/lessons/seismograph/challenges)
+* [challenge](/lessons/seismograph/challenge)
 
 ## Prior learning/place of lesson in scheme of work 
 
@@ -18,11 +18,12 @@ Learn how to **show LEDs** to turn on a LED light pattern on the LED screen. We
 ## Documentation
 
 ```cards
-basic.forever(() => {
-});
-led.plotBarGraph(input.acceleration(Dimension.Strength) - 1023, 0);
-led.plotBarGraph(pins.analogReadPin(AnalogPin.P0), 0);
-
+basic.forever(() => {});
+radio.sendNumber(0);
+input.acceleration(Dimension.Strength)
+radio.onDataReceived(() => {});
+led.plotBarGraph(0, 0);
+radio.receiveNumber();
 ```
 
 ## Objectives

docs/lessons/seismograph/activity.md

@@ -1,53 +1,56 @@
 # Seismograph Activity 
 
+Welcome! In this project, you will build your own seismograph. This activity will teach how to use the micro:bit to chart the strength of the acceleration. Let's get started! Project duration: 25 minutes.
+
 ### ~avatar avatar
 
-In this project, you will build your own seismograph. 
+Engineering: In this project, you will build your own seismograph micro:bit from tape and a household plate. 
+
+### ~
 
 ## What you'll need: 
 
-* micro:bit 
-* USB cable
+* BBC micro:bit 
+* micro USB cable
+* Plate 
+* Tape 
 * Scissors
-* Glue gun
-* String
-* Cup (Plastic or Paper)
-* Magnet
 
-Welcome! This activity will teach how to use the micro:bit to chart the strength of the acceleration. Let's get started!
+![](/static/mb/lessons/seismograph11.png)
 
-1. Setup Cup: Use scissors to cut a usable window on the cup, which will be a square sized hole at the lid side of the cup. Use scissors to create a small hole in the center of the base of the cup. 
+# Engineering Steps
 
-2. Fasten Magnet: Fasten end of the string to the magnet with glue
+## 1. 
 
-3. Secure String: Fasten string to base of the cup and hang the remaining string outside the base of the cup. 
+Prepare Tape: Measure and cut approximately 10mm of tape. The tape will be fastened to a micro USB cable.  
+
+![](/static/mb/lessons/seismograph1.png)
+
+## 2. 
+
+Fasten Tape: Fasten tape to the micro USB cable and to the plate. Attach the micro:bit to the micro:bit USB cable. 
+
+![](/static/mb/lessons/seismograph0.png)
 
 ### ~avatar avatar
 
-Seismograph built, let's code! 
+Computer Science: The seismograph has been built. We are ready to program the micro:bit to be a seismograph! 
 
 ### ~
 
-4. Go to Codemicrobit.com
-
-    Click or tap Create Code
-    Click or tap Block Editor
+# Programming Steps
     
-### ~
+## 3. 
 
-5. 
-
-We will measure `acceleration (mg)` in terms of strength. Get the acceleration value (milli g-force), as measured in strength.
+We will measure `acceleration (mg)` in terms of strength or Magnitude.
 
 ```blocks
 input.acceleration(Dimension.Strength);
 ```
 
-### ~
+## 4. 
 
-6. 
-
-Use the plot bar chart to visualize the acceleration on the LED screen of the micro:bit in the specified range. You implement plot Bar Graph to display a vertical bar graph based on the "value" and "high" value. Then you must insert acceleration in based on strength. 
+Use the plot bar chart to visualize the acceleration on the LED screen. Use a forever to keep reading the acceleration value and displaying it on the screen.
 
 ```blocks
 basic.forever(() => {
@@ -56,11 +59,9 @@ basic.forever(() => {
 
 ```
 
-### ~
+## 6. 
 
-7. 
-
-Finally, we subtract the gravity from acceleration strength. 
+At rest, the micro:bit is always subject to Earth gravity, whose magnitude is measured around ``1023``. Substract ``1023`` to measure a data close to ``0``. 
 
 ```blocks
 basic.forever(() => {
@@ -71,76 +72,113 @@ basic.forever(() => {
 
 ### ~
 
-8. 
-
-Notice that making vibrating the object below the micro:bit changes the values and the line appears as a wave to display the value of the strength as measured in milli-gravities. By making the object below the micro:bit vibrate, you will observe changing values of the micro:bit. Also, the LEDs shown on the Bar Graph fluctates based on the movement of the micro:bit strength. 
-
-NOTE: The black color reflects the micro:bit device. 
-
-![](/static/mb/data4.png)
+### ~avatar avatar
 
+Data Analysis: We now need to use the micro:bit to Analyze Data and chart for the strength of the acceleration.
 
 ### ~
 
-9. 
+# Data Analysis Steps
+
+## 7. 
+
+First, notice that moving the micro:bit in the simulator in any direction, you will change the acceleration value, which is being displayed as the same color as the micro:bit simulator. Also, notice that by moving the micro:bit simulator, there is a changing acceleration value. Second, the flat colored horizontal line will start a waving line to display the value of the strength as measured in milli-gravities. Finally, notice that the LED display will fluctate based on the movement of the micro:bit simulator. 
+
+![](/static/mb/lessons/analyze20.png)
+
+## 8. 
  
-Vigorously move the micro:bit in the micro:bit simulatator by moving the micro:bit image from side to side. Every time the micro:bit moves in the x direction in the simulator,  you are generating data points that can be reviewed in Excel. The more attempts to move the micro:bit from side to side, the more data being saved in Excel. After you have vigarously moved the micro:bit simulator from side to side for a sufficient amount of time, you are ready to graph or chart the accceleration of the micro:bit. We want a printout of our acceleration on Excel that can be graphed in Excel. 
+Connect a micro:bit to your computer using your USB cable
+
+![](/static/mb/lessons/seismograph33.png)
+
+Click or tap the compile button for the seismograph program to run the program on the micro:bit. 
+
+![](/static/mb/lessons/seismograph22.png)
+
+## 9. 
+
+A black line should appear directly beneath the colored line. The black line measures the micro:bit acceleration.  And the colored line measures micro:bit simulator acceleration. 
+
+Run the acceleration experiment by vigarously moving the plate in any direction or move the object below the micro:bit (such as a table).
+
+Every time the micro:bit moves in any direction,  you generate data points that can be reviewed in Excel later. The more attempts to move the micro:bit, the more data to be reviewed in Excel.  
+
+![](/static/mb/lessons/seismograph5.png)
+
+## 10. 
+
+Please find seismogrph experiment obervations: 
+
+First, notice that moving the micro:bit in any direction, you will change the acceleration value, which is being displayed as a milli-gravities value. By moving the micro:bit, there will be a changing acceleration value. 
+
+![](/static/mb/lessons/seismograph7.png)
+
+Second, the horizontal line will move to plot the value of the strength as measured in milli-gravities. The horizontal line's movement is based on the micro:bit acceleration in Magnitude or Strength. 
+
+![](/static/mb/lessons/seismograph6.png)
+
+Third, notice that the LED display fluctates based on the movement of the micro:bit. 
+
+![](/static/mb/lessons/seismograph8.png)
+
+Now we are ready to graph or chart the accceleration of the micro:bit. We want a printout of the micro:bit acceleration graphed in Excel.
+
+## 11. 
+
+In order to receive the the data plotted by Excel, click or tap anywhere in the on the chart data.
+
+![](/static/mb/analyze1.png)
+  
+## 12. 
+
+You have two options to Analyze Data: 
+
+* Local File: Save the data to your local Downloads folder and open it in Excel. 
+* Stream to Cloud: Upload your data to Microsoft Azure to analyze it. 
+
+Click or tap Download data
+
+![](/static/mb/lessons/seismograph9.png)
+
+## 13. 
+
+A CSV file will be generated to display the data points collected by the micro:bit. Click or tap on the data Excel file that was downloaded to your local Downloads Folder. 
+
+![](/static/mb/lessons/analyze9.png)
+
+## 14.
+
+Select the data that you want to include in your chart. The chart should include the first two columns: time and acceleration. 
+
+Click or tap on the first two columns (A, B) to include time and acceleration data from the micro:bit  
 
 
-### ~
+## 15.
 
-10. 
+Click or tap on Insert then select Recommended Charts. We can select a chart that’s just right for the data.
 
-We want to chart the data collected by using a tool in Excel. 
+![](/static/mb/analyze3.png)
 
-The final part of this experiment is opening and reviewing the data in the Excel CSV file. Simply click on the line beneath the simulator. A CSV file will be generated to display the data points collected by moving the micro:bit in the X direction. Then click or tap on the data Excel file that was downloaded to your local Downloads Folder. 
+On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data. 
 
+We want to select the chart called Line. A line chart is used to display trends over time. We will use the line chart because there are many data points over time. 
 
-### ~
+Click on the chart type to see how your data will look in that format. When you find the chart type that you want, click it, and then click OK. 
 
-10. 
+![](/static/mb/lessons/analyze16.png)
 
+Tip: If you don’t see the line chart, click the All Charts tab to see the line chart.
 
-First, click or tap on the first two columns (A, B) to  include the time of the data being collected; b) the results of acceleration data on the micro:bit  
+## 16. 
 
-![](/static/mb/data7.png)
+Use the Chart Elements, Chart Styles, and Chart Filters buttons next to the upper-right corner of the chart to add chart elements like axis titles or data labels, to customize the look of your chart
 
-Use the Recommended Charts command on the Insert tab to quickly create a chart that’s just right for your data.
+Alternatively, click or tap on the Design Ribbon. 
 
-* Select the data that you want to include in your chart.
+Let's select Style 10 as an example. 
 
-* Click Insert > Recommended Charts.
-
-### ~
-
-11. 
-
-
-![](/static/mb/chart1.png)
-
-* On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data.
-
-Click any chart type to see how your data will look in that format. 
-
-When you find the chart type that you want, click it, and then click OK. We want to select the chart called Line. A line chart is used to display trends over time. We will use the line chart because there are many data points over time. 
-
-Tip: If you don’t see a chart type that you want, click the All Charts tab to see all of the available chart types.
-
-### ~
-
-12. 
-
-![](/static/mb/chart_title.png)
-
-* Use the Chart Elements, Chart Styles, and Chart Filters buttons next to the upper-right corner of the chart to add chart elements like axis titles or data labels, to customize the look of your chart
-
-### ~
-
-13. 
-
-![](/static/mb/elements_styles_filters.png)
-
-* Connect a micro:bit to your computer using your USB cable; compile; and repeat this experiment by vibrating the micro:bit. Then chart the data on Excel. 
+![](/static/mb/lessons/analyze19.png)
 
 ### ~avatar avatar
 

docs/lessons/seismograph/challenge.md

@@ -1,94 +1,198 @@
-# Challenge 
+# Seismograph Challenge 
 
-### ~avatar avatar 
+Coding challenges for the seismograph. 
 
-Welcome! The activity will teach you how to use the acceleration of the 1st micro:bit and to visualize the acceleration on the 2nd micro:bit. Let's get started!
+
+### ~avatar avatar
+
+Engineering: In this project, you will build a remote control based on the seismograph micro:bit activity using a second micro:bit and micro USB cable. 
 
 ### ~
-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));
-```
-### ~
-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.
+## What you'll need: 
+
+* BBC micro:bits (2)
+* micro USB cables (2) 
+* Plate 
+* Tape 
+* Scissors
+
+![](/static/mb/lessons/seis_challenge01.png)
+
+## Before we get started
+
+Complete the [seismograph](/lessons/seismograph/activity) activity and your code will look like this:
 
 ```blocks
 basic.forever(() => {
-    radio.sendNumber(input.acceleration(Dimension.X));
+    led.plotBarGraph(input.acceleration(Dimension.Strength) - 1023, 0);
 });
 
+```
+
+### ~avatar avatar 
+Computer Science: Welcome! The activity will teach you how to code the acceleration of the 1st micro:bit and to visualize the acceleration on the 2nd micro:bit. Let's get started!
+### ~
+
+# Computer Science Steps
+
+## 1.
+We want to simply detach the blocks from the recent activity. We will use blocks from the activity to create a brand new program to show the way micro:bit devices communicate through the BLE (Bluetooth low energy) radio. 
+
+```shuffle
+basic.forever(() => {
+    led.plotBarGraph(input.acceleration(Dimension.Strength) - 1023, 0);
+});
 
 ```
-### ~
-We want to register code to run when a packet is received over radio. We can implement this code by adding `on data received`.
+
+## 2. 
+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.
+
+We need add send number block found in the Radio drawer. We will attach send number to acceleration and subtract the gravity from acceleration strength.  
+
+Your finished code will look like this:
+
+```blocks
+radio.sendNumber(input.acceleration(Dimension.Strength) - 1023);
+```
+
+## 3. 
+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. We need attach forever loop to send number. 
+
+Your finished code will look like this:
 
 ```blocks
 basic.forever(() => {
-    radio.sendNumber(input.acceleration(Dimension.X))
-})
-radio.onDataReceived(() => {
-    
-})
+    radio.sendNumber(input.acceleration(Dimension.Strength) - 1023);
+});
+
 ```
-### ~
+
+## 4. 
+We want to register code to run when a packet is received over radio. We can implement this code by adding `on data received`block found in the radio drawer.
+
+Your finished code will look like this:
+
+```blocks
+basic.forever(() => {
+    radio.sendNumber(input.acceleration(Dimension.Strength) - 1023);
+});
+radio.onDataReceived(() => {
+});
+
+```
+
+## 5. 
 Finally, we want to chart the acceleration. So we must first implement `plot bar graph`. `Plot Bar Graph` will display a vertical bar graph based on the value and high value. In order to transfer the receive the number from the 1st micro:bit, we must implement `receive number` to constantly display a vertical bar graph based on the value. Remember, the value will equal to the micro:bit's acceleration in the "x" direction.
 
+Your finished code will look like this:
+
 ```blocks
 basic.forever(() => {
-    radio.sendNumber(input.acceleration(Dimension.X))
-})
+    radio.sendNumber(input.acceleration(Dimension.Strength) - 1023);
+});
 radio.onDataReceived(() => {
-    led.plotBarGraph(radio.receiveNumber(), 1023)
-})
-
+    led.plotBarGraph(radio.receiveNumber(), 0);
+});
 ```
-### ~
-Notice that moving the micro:bit the farthest direction in the x direction will be -1023 on the charting beneath the simulator. The second observation will be that the LEDs will be full brightness on the 2nd micro:bit. There is a single LED turned on with the 1st micro:bit. Additionally, the graphs will reflect 0 acceleation for the 1st micro:bit. In this scenario, if you are adjusting the acceleration in the simualator, you are also changing your chart that will be produced.  
-
-![](/static/mb/acc.png)
 
+### ~avatar avatar 
+Science: Welcome! The activity will teach you how to chart the acceleration of the 1st micro:bit and to visualize the acceleration on the 2nd micro:bit. Let's get started!
 ### ~
-NOTE: The colors of the charts reflect the color of the micro:bit simulator. In this instance, the micro:bits are blue and green. So the colors of the line graphs reflect the colors of the micro:bit
+
+# Science Steps
+
+## 6. 
+First, notice that moving the 1st micro:bit in the simulator in any direction, you will change the acceleration value of the 2nd micro:bit. Also, notice that by moving the micro:bit simulator, there is a changing acceleration value of the second micro:bit. Second, the flat colored horizontal line will start a waving line on the 2nd micro:bit to display the value of the strength as measured in milli-gravities. Finally, notice that the LED display will fluctate based on the movement of the 2nd micro:bit simulator.
+
+![](/static/mb//lessons/seis_challenge02.png)
+
+## 7. 
  
- ### ~
-After running this simulatation several seconds by moving the micro:bit side to side in the x direction, you are ready to graph or chart the accceleration of the micro:bit.  We want a printout of our acceleration on Excel. We will graph the fluctuating acceleration of the simulation experiment. 
+Connect the 2nd micro:bit to your computer using your USB cable. We should have two micro:bit devices attached to the computer. 
+
+![](/static/mb/lessons/seismograph33.png)
+
+## 8.
+
+Click or tap the compile button for the seismograph program to run the program on the 1st micro:bit and 2nd micro:bit.
+
+## 9. 
+
+The black lines should appear directly beneath the colored lines. The black lines measure the micro:bit acceleration. And the colored lines measures micro:bit simulator acceleration.
+
+![](/static/mb/lessons/seis_challenge05.png)
+
+Run the acceleration experiment by vigarously moving the plate in any direction or move the object below the micro:bit (such as a table).
+
+![](/static/mb/lessons/seis_challenge06.png)
+
+Every time the micro:bit moves in any direction, you generate data points that can be reviewed in Excel later. The more attempts to move the micro:bit, the more data to be reviewed in Excel. Notice that the LED on the 2nd micro:bit changes to communicate the movement of the 1st micro:bit.
+
+![](/static/mb/lessons/seis_challenge04.png)
+
+Now we are ready to graph or chart the accceleration of the micro:bit. We want a printout of the micro:bit acceleration graphed in Excel.
+
+## 10. 
+
+In order to receive the the data plotted by Excel, click or tap anywhere in the on the chart data.
+
+![](/static/mb/lessons/seis_challenge07.png)
+
+## 11. 
+
+You have two options to Analyze Data: 
+
+* Local File: Save the data to your local Downloads folder and open it in Excel. 
+* Stream to Cloud: Upload your data to Microsoft Azure to analyze it. 
+
+Click or tap Download data
+
+![](/static/mb/lessons/seismograph9.png)
+
+## 12. 
+
+A CSV file will be generated to display the data points collected by the micro:bit. Click or tap on the data Excel file that was downloaded to your local Downloads Folder. 
+
+![](/static/mb/lessons/analyze9.png)
+
+## 13.
+
+Select the data that you want to include in your chart. The chart should include the first two columns: time and acceleration. 
+
+Click or tap on the first two columns (A, B) to include time and acceleration data from the micro:bit. We only need the first two columns (A, B) because the 2nd micro:bit changes have been communicated by the 1st micro:bit. So the data points of the seismograph are being recorded on the 1st micro:bit. 
+
+## 14.
+
+Click or tap on Insert then select Recommended Charts. We can select a chart that’s just right for the data.
+
+![](/static/mb/analyze3.png)
+
+On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data. 
+
+We want to select the chart called Line. A line chart is used to display trends over time. We will use the line chart because there are many data points over time. 
+
+Click on the chart type to see how your data will look in that format. When you find the chart type that you want, click it, and then click OK. 
+
+![](/static/mb/lessons/analyze16.png)
+
+Tip: If you don’t see the line chart, click the All Charts tab to see the line chart.
+
+## 15. 
+
+Use the Chart Elements, Chart Styles, and Chart Filters buttons next to the upper-right corner of the chart to add chart elements like axis titles or data labels, to customize the look of your chart
+
+Alternatively, click or tap on the Design Ribbon. 
+
+Let's select Style 10 as an example. 
+
+![](/static/mb/lessons/analyze19.png)
 
-![](/static/mb/acc2.png)
 
 ### ~
-Finally, you must open the Excel CSV file by clicking on the data.xls file that was downloaded to Downloads Folder. 
-
-![](/static/mb/data3.png)
-
-Use the Recommended Charts command on the Insert tab to quickly create a chart that’s just right for your data.
-
-* Select the data that you want to include in your chart.
-
-* Click Insert > Recommended Charts.
-
-![](/static/mb/chart1.png)
-
-* On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data.
-
-Click any chart type to see how your data will look in that format. 
-
-When you find the chart type that you want, click it, and then click OK. We want to select the chart called Line. A line chart is used to display trends over time. We will use the line chart because there are many data points over time. 
-
-Tip: If you don’t see a chart type that you want, click the All Charts tab to see all of the available chart types.
-
-![](/static/mb/chart_title.png)
-
-* Use the Chart Elements, Chart Styles, and Chart Filters buttons next to the upper-right corner of the chart to add chart elements like axis titles or data labels, to customize the look of your chart
-
-![](/static/mb/elements_styles_filters.png)
-
-### ~
-Have fun reviewing your simulation and analyze the acceleration by chart the Excel data using Excel.
-
-* Connect the first micro:bit to your computer using your USB cable and run the charting script on it.
-* Connect the second micro:bit to your computer using your USB cable and run the charting script on it.
-* The first person and second person take turns tilting the micro:bit in the "x" direction while the other player charts the data on the micro:bit!
+* Have fun reviewing your seismograph data and analyzing the acceleration with Excel.
+* The first person and second person take shaking or moving the micor:bit in any direction while the other player charts the data on the micro:bit!
 * Review and analyze the actual micro:bit device acceleration data on Excel
-* Display acceleration with y or z using plot bar graph by changing acceleration from "x" to "y" or "z" 
+