0.2.144

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/getting-started.md

@@ -1,32 +1,17 @@
 # Getting started
 
-Are you ready to build cool BBC micro:bit programs? For each challenge, reorder the blocks to recreate the program.
+Are you ready to build cool BBC micro:bit programs?
 
-### Show leds
+Here are some challenges for you.  Unscramble the blocks in the editor
+to make real programs that work!
 
-Use the blocks below to draw a figure on the screen. You can redo the smiley face or try something else!
+### Happy face
 
-```shuffle
+You should see three blocks in the editor to the left.
-basic.showLeds(`
+These are a block with a smiley face, ...
-    . . . . .
-    . # . # .
-    . . . . .
-    # . . . #
-    . # # # .
-    `)
-```
-
-To transfer your code to the BBC micro:bit, 
-* connect your micro:bit to the computer using the USB cable
-* click on **Compile**
-* drag&drop the **.hex** file into the **MICROBIT** drive
-* wait till the yellow light is done blinking!
-
-### Show animation Forever
-
-Show one image after the other to create an animation by snapping them together.
 
 ```blocks
+basic.forever(() => {
     basic.showLeds(`
         . . . . .
         . # . # .
@@ -36,25 +21,26 @@ Show one image after the other to create an animation by snapping them together.
         `)
     basic.showLeds(`
         . . . . .
-        . # . # .
         . . . . .
-        . # # # .
+        . . . . .
-        # . . . #
+        . . . . .
+        . . . . .
         `)
+});
 ```
 
-To transfer your code to the BBC micro:bit, 
+To move your program from your computer to the BBC micro:bit:
-* connect your micro:bit to the computer using the USB cable
+* Connect your micro:bit to the computer with the USB cable.
-* click on **Compile**
+* Click **Compile**.
-* drag&drop the **.hex** file into the **MICROBIT** drive
+* Drag and drop the new file whose name ends in **.hex** into the **MICROBIT** window.
-* wait till the yellow light is done blinking!
+* Wait until the yellow light stops blinking!
 
-### Repeat forever
+### Happy unhappy face
 
-Use the ``forever`` block to repeat your code and have a continuous animation.
+Let's draw an unhappy face instead of the blank screen. Click on the dots in the ``show leds`` block
+until it matches the blocks below.
 
-Unsuffle the blocks to create a happy, unhappy animation.... or changes the image to make it your own!
+```blocks
-```shuffle
 basic.forever(() => {
     basic.showLeds(`
         . . . . .
@@ -73,37 +59,82 @@ basic.forever(() => {
 });
 ```
 
-### Your turn now!
+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!
 
-Use the blocks ``show leds`` and ``forever``
+### Your turn!
-to create your own custom awesome animation!
 
-### Button A and B
+Pile up more ``show leds`` blocks to create your animation! Create an animation with at least 5 images.
-
-Unshuffle the blocks so that the micro:bit shows "YES" when button A is pressed, and "NO" when B is pressed. 
-The key idea is that all the blocks nested under `on button ... pressed` will run when that button is pressed.
 
 ```blocks
-input.onButtonPressed(Button.A, () => {
+basic.forever(() => {
-    basic.showString("AAAAA");
+    basic.showLeds(`
+        . . . . .
+        . # . # .
+        . . . . .
+        # . . . #
+        . # # # .
+        `)
+    basic.showLeds(`
+        . . . . .
+        . # . # .
+        . . . . .
+        . # # # .
+        # . . . #
+        `)
+    basic.showLeds(`
+        . . . . .
+        . # . # .
+        . . . . .
+        # # # # #
+        . . . . .
+        `)
 });
 ```
 
-Try to unshuffle those blocks:
+To move your program from your computer to the BBC micro:bit:
-```shuffle
+* 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 under the **Basic** category.
+#### ~
+
+### Button A and B
+
+This program will show the word `banana` on the LED
+screen when you press button `A`.
+
+```blocks
 input.onButtonPressed(Button.A, () => {
-    basic.showString("YES");
+    basic.showString("banana");
 });
+```
+
+Now try to unscramble these blocks in the editor so that the micro:bit
+shows **apple** when you press button `B`.
+
+```shuffle
 input.onButtonPressed(Button.B, () => {
-    basic.showString("NO");
+    basic.showString("apple");
 });
 ```
 
 ### Shake
 
-Using the data from the **accelerometer**, it is possible to detect that the BBC micro:bit is being shaken.
+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.
 
-Unshuffle the code to display a frownie when shaken.
 ```shuffle
 input.onGesture(Gesture.Shake, () => {
     basic.showLeds(`
@@ -115,12 +146,18 @@ input.onGesture(Gesture.Shake, () => {
 });
 ```
 
-### Tilting
+### Tilting with gestures
 
-Aside from shake, it is also possible to detect tilt left and right, logo up and down or face up and down.
+You can also find when someone is tilting the micro:bit left or right,
-Let's build a rock paper scissors game where you turn the micro:bit left to display paper, right to display scissors and down to display rock.
+face up or face down, and logo up or logo down (the logo is the yellow
+oval picture at the top of the board).
+
+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 the
+micro:bit itself!
 
-Unshuffle and try this code on the micro:bit itself!
 ```shuffle
 input.onGesture(Gesture.TiltLeft, () => {
     basic.showLeds(`
@@ -150,10 +187,14 @@ input.onGesture(Gesture.TiltRight, () => {
 
 ### Pins
 
-It is possible to use the pins (big metal bar at the bottom of the board) as button. Hold the ``GND`` button with one hand and press the ``0`` pin 
+You can also use the pins as buttons.  (The pins are the holes in the
-(called ``P0``) with the other hand to trigger a pin pressed.
+metal bar 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``.
 
-Unshuffle the blocks to display a smiley when pin ``P0`` is pressed.
 ```shuffle
 input.onPinPressed(TouchPin.P0, () => {
     basic.showLeds(`
@@ -165,6 +206,7 @@ input.onPinPressed(TouchPin.P0, () => {
 });
 ```
 
-### Your turn now!
+### Your turn!
 
-Use the screen, buttons, gestures, pins to create a fun game using the micro:bit.
+Use the screen, buttons, gestures, and pins to make your own fun game
+with the BBC micro:bit!

docs/lessons.md

@@ -59,6 +59,7 @@
 
 ## 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

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/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/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.
+* On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data. Pick the **scatter plot**.
-
-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" 
 
 ### ~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.
+* On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data. Pick the **scatter plot**.
-
-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)
 
@@ -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/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/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/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/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/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
 

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
 

docs/lessons/rock-paper-scissors.md

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

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/screen-wipe.md

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

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(`

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(() => {
+basic.forever(() => {});
-});
+radio.sendNumber(0);
-led.plotBarGraph(input.acceleration(Dimension.Strength) - 1023, 0);
+input.acceleration(Dimension.Strength)
-led.plotBarGraph(pins.analogReadPin(AnalogPin.P0), 0);
+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 
+* BBC micro:bit 
-* USB cable
+* 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
+# Programming Steps
     
-    Click or tap Create Code
+## 3. 
-    Click or tap Block Editor
 
-### ~
+We will measure `acceleration (mg)` in terms of strength or Magnitude.
-
-5. 
-
-We will measure `acceleration (mg)` in terms of strength. Get the acceleration value (milli g-force), as measured in strength.
 
 ```blocks
 input.acceleration(Dimension.Strength);
 ```
 
-### ~
+## 4. 
 
-6. 
+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.
-
-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. 
 
 ```blocks
 basic.forever(() => {
@@ -56,11 +59,9 @@ basic.forever(() => {
 
 ```
 
-### ~
+## 6. 
 
-7. 
+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``. 
-
-Finally, we subtract the gravity from acceleration strength. 
 
 ```blocks
 basic.forever(() => {
@@ -71,76 +72,113 @@ basic.forever(() => {
 
 ### ~
 
-8. 
+### ~avatar avatar
-
-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)
 
+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
 
-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. 
+## 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. 
+ 
+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.
+![](/static/mb/lessons/analyze19.png)
-
-### ~
-
-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. 
 
 ### ~avatar avatar
 

docs/lessons/seismograph/challenge.md

@@ -1,94 +1,198 @@
-# Challenge 
+# Seismograph Challenge 
+
+Coding challenges for the seismograph. 
+
 
 ### ~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!
+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
+## What you'll need: 
-radio.sendNumber(input.acceleration(Dimension.X));
+
-```
+* BBC micro:bits (2)
-### ~
+* micro USB cables (2) 
-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.
+* 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.sendNumber(input.acceleration(Dimension.Strength) - 1023);
-})
+});
-radio.onDataReceived(() => {
 
-})
 ```
-### ~
+
+## 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!
+### ~
+
+# 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. 
+ 
+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)
+
 
 ### ~
-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
+* 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!
- ### ~
-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. 
-
-![](/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!
 * 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/smiley.md

@@ -1,8 +1,6 @@
 # smiley blocks lesson 
 
-design a blinking image lesson #docs
+Design a blinking image lesson
-
-
 
 ## Topic 
 

docs/lessons/snowflake-fall.md

@@ -21,10 +21,6 @@ Learn how to show LEDs with a, `pause` to pause program execution for a specifie
 
 ## Documentation
 
-* **show LEDs** : [read more...](/reference/basic/show-leds)
-* **pause** : [read more...](/reference/basic/pause)
-* **forever** : [read more...](/reference/basic/forever)
-
 ```cards
 basic.showLeds(`
     . . . . .

docs/lessons/speed-button/activity.md

@@ -1,6 +1,6 @@
 # speed button challenges
 
-Coding challenges for the speed button tutorial. #docs
+Coding challenges for the speed button tutorial.
 
 ## Before we get started
 

docs/lessons/spinner.md

@@ -21,7 +21,6 @@ Learn how to use an if statement to run code run code depending on whether a con
 
 ## Documentation
 
-
 ```cards
 if (true) {}
 let x = 0

docs/lessons/stem.md

@@ -41,7 +41,7 @@ Overview of Blocks lessons for the BBC micro:bit.
 * [The Watch](/lessons/the-watch), design and create The Watch
 * [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
 * [Beatbox](/lessons/classic-beatbox), make a beatbox music player with variables
 * [Temperature](/lessons/temperature), get the ambient temperature (degree Celsius °C)
 

docs/lessons/telegraph.md

@@ -14,7 +14,8 @@ Telegraph
 
 ## Prior learning/place of lesson in scheme of work
 
-Learn how to convert your BBC micro:bit into a telegraph using a second BBC micro:bit as well as pin P1, P2, 3V, GND, and crocodile clips (or spring clips). The connect BBC micro:bit uses pins P1, P2, 3V, GND.
+Learn how to convert your BBC micro:bit into a telegraph using a second BBC micro:bit as well as pin P1, P2, 3V, GND, 
+and crocodile clips (or spring clips). The connect BBC micro:bit uses pins P1, P2, 3V, GND.
 
 ## Objectives
 

docs/lessons/variables.md

@@ -1,6 +1,6 @@
 # Blocks - Variables
 
-An introduction to variables for the Block Editor. #docs
+An introduction to variables for the Block Editor.
 
 ## What is a variable?
 

docs/projects/rock-paper-scissors.md

@@ -37,8 +37,11 @@ In this project, you will build a Rock Paper Scissors game with the BBC micro:bi
 You can play the game with a friend who has it on a micro:bit.
 You can also play it with friends who are just using their hands.
 
+## [START PROJECT](/#follow:/projects/rock-paper-scissors)
+
 ### ~
 
+
 ## Materials needed
 
 * Your BBC micro:bit -- that's it!

docs/reference/game/game-library.md

@@ -1,18 +1,10 @@
 # Game Library
 
-The game library #docs
-
 The game library supports simple single-player time-based games. The player has a **sprite**, number of **lives** and a **score**. The game has a sprite, number of **levels** and a **countdown clock**.  The general goal of a game will be to move the sprite and achieve a top score before time runs out or the number of lives goes to zero.
 
-## Block Editor
-
-![](/static/mb/game-library/pic0.png)
-
-## KindScript
-
 The code below shows a simple game where the user gets to press the button ``A`` as much times as possible in 10 seconds.
 
-```
+```blocks
 input.onButtonPressed(Button.A, () => {
     game.addScore(1)
 })

docs/reference/game/move.md

@@ -1,16 +1,6 @@
 # Move
 
-The game library 
+Sprite move by a certain number of LEDs
-
-### Move
-
-Sprite move by a certain number
-
-## Block Editor
-
-![](/static/mb/game-library/move-0.png)
-
-## KindScript
 
 ```
 export function move(_this: micro_bitSprites.LedSprite, leds: number)

docs/reference/game/position.md

@@ -1,19 +1,5 @@
 # Position
 
-The game library 
-
-### Create sprite
-
-Reports the x or y position of a sprite on the LED screen
-
-## Block Editor
-
-Reports the x position of a sprite on the LED screen
-
-![](/static/mb/game-library/position-0.png)
-
-## KindScript
-
 Reports the x position of a sprite on the LED screen
 
 ```

docs/reference/game/reports.md

@@ -1,31 +1,7 @@
 # Reports
 
-The game library
-
-### Reports
-
 Reports the x or y position,  the current direction of a sprite, or the brightness of a sprite on the LED screen
 
-## Block Editor
-
-Reports the x position of a sprite on the LED screen
-
-![](/static/mb/game-library/position-0.png)
-
-Reports the y position of a sprite on the LED screen
-
-![](/static/mb/game-library/reports-0.jpg)
-
-Reports the brightness of a sprite on the LED screen
-
-![](/static/mb/game-library/reports-1.jpg)
-
-Reports the direction of a sprite on the LED screen
-
-![](/static/mb/game-library/reports-2.jpg)
-
-## KindScript
-
 Reports the x position of a sprite on the LED screen
 
 ```

docs/reference/game/score.md

@@ -1,20 +1,10 @@
 # Score
 
-The game library #docs
-
 The game library supports simple single-player games. The player has a **score**.
 
-## Block Editor
-
-The code below shows a simple game where the user gets to press the button ``A`` and adds 1 point to score that will be displayed on the BBC micro:bit screen
-
-![](/static/mb/game-library/add-point-to-score-0.png)
-
-## KindScript
-
 The code below shows a simple game where the user gets to press the button ``A`` as much times as possible in 10 seconds.
 
-```
+```blocks
 input.onButtonPressed(Button.A, () => {
     game.addScore(1)
 })

docs/reference/game/start-countdown.md

@@ -1,15 +1,5 @@
 # Start Countdown
 
-The game library #docs
-
-The game library supports simple single-player time-based games. The general goal of a game will be to achieve a top score before time runs out of time.
-
-## Block Editor
-
-![](/static/mb/game-library/start-countdown-0.png)
-
-## KindScript
-
 The code below shows a simple game where the user gets to press the button ``A`` as much times as possible in 10 seconds.
 
 ```

docs/reference/game/touching.md

@@ -1,17 +1,5 @@
 # Touching
 
-The game library 
-
-### Touching
-
-Reports true if sprite is touching specified sprite
-
-## Block Editor
-
-![](/static/mb/game-library/touching-0.png)
-
-## KindScript
-
 Reports true if sprite is touching specified sprite
 
 ```

docs/reference/game/turn.md

@@ -1,17 +1,5 @@
 # Turn
 
-The game library 
-
-Rotates a sprite to the right by a certain number of degrees
-
-## Block Editor
-
-Rotates a sprite to the right by a certain number of degrees
-
-![](/static/mb/game-library/turn-0.png)
-
-## KindScript
-
 Rotates a sprite to the right by a certain number of degrees
 
 ```

docs/reference/radio/on-data-received.md

@@ -1,13 +1,19 @@
 # On Data Received
 
-Registers code to run when a packet is received over ``radio``.
+Run part of a program when the micro:bit receives a
+[number](/reference/types/number) or [string](/reference/types/string) over ``radio``.
 
 ### Parameters
 
-* body - is an action
+* **body** is the part of the program to run when the micro:bit receives information over ``radio``.
 
 ### Example
 
+This program never stops.  It keeps sending numbers that says how
+fast the micro:bit is slowing down or speeding up.  It also receives
+numbers that say how fast nearby micro:bits are going. It
+shows these numbers as a [bar graph](/reference/led/plot-bar-graph).
+
 ```blocks
 basic.forever(() => {
     radio.sendNumber(input.acceleration(Dimension.X));
@@ -19,5 +25,6 @@ radio.onDataReceived(() => {
 
 ### See also
 
-[receive number](/reference/radio/receive-number), [send number](/reference/radio/send-number), [set group](/reference/radio/set-group)
+[receive number](/reference/radio/receive-number),
+[send number](/reference/radio/send-number), [set group](/reference/radio/set-group)
 

docs/reference/radio/set-group.md

@@ -1,16 +1,22 @@
 # Set Group
 
-Sets the group id for ``radio`` communications. A micro:bit can only listen to one group ID at any time.
+Make a program have the group ID you tell it for sending and receiving
+with ``radio``.  A group is like a cable channel (a micro:bit can only
+send or receive in one group at a time). A group ID is like the cable
+channel number.
 
-Unless specified, the group id is automatically inferred from the script source. Every script with the same exact source code with start with the same group id.
+If you do not tell your program which group ID to use with this
+function, it will figure out its own group ID by itself.  If you load
+the very same program onto two different micro:bits, they will be able
+to talk to each other because they will have the same group ID.
 
 ### Parameters
 
-* ``id`` -- a [number](/reference/types/number) between ``0`` and ``255``.
+* ``id`` is a [number](/reference/types/number) from ``0`` to ``255``.
 
 ### Example
 
-Sets the group to 128.
+This program makes the group ID equal 128.
 
 ```blocks
 radio.setGroup(128)

docs/release-notes.md

@@ -4,7 +4,12 @@
 basic.forever(() => { basic.showString("RELEASE NOTES"); });
 ```
 
-## May 2017
+## June 2016
+
+* It is now possible to stream data into the cloud (Azure) from the PXT editor. Simply click on the log view to get started.
+* Documentation column pops up for large screen to avoid switching between docs and editor.
+
+## May 2016
 
 We're happy to announce [m.pxt.io](https://m.pxt.io), an Blocks/JavaScript editor for the [BBC micro:bit](https://www.microbit.co.uk). 
 The editor is [open source](/open-source) on GitHub. Send us your PR!