From d76d92e041c20d9a9a2c00332561776b92b29cb9 Mon Sep 17 00:00:00 2001 From: Peli de Halleux Date: Tue, 1 Nov 2016 10:42:42 -0700 Subject: [PATCH] inserting macros instead of hard coded board names --- docs/docs.md | 6 ++--- docs/getting-started.md | 2 +- docs/getting-started/buttons.md | 8 +++---- docs/getting-started/coin-flipper.md | 2 +- docs/getting-started/rock-paper-scissors.md | 6 ++--- docs/getting-started/screen.md | 4 ++-- docs/getting-started/shake.md | 4 ++-- docs/lessons.md | 6 ++--- docs/lessons/answering-machine.md | 2 +- docs/lessons/beautiful-image.md | 4 ++-- docs/lessons/blocks-conditions.md | 12 +++++----- docs/lessons/bop-it/activity.md | 2 +- docs/lessons/bop-it/quiz-answers.md | 4 ++-- docs/lessons/bop-it/quiz.md | 4 ++-- docs/lessons/catch-the-egg-game.md | 2 +- .../catch-the-egg-game/quiz-answers.md | 2 +- docs/lessons/catch-the-egg-game/quiz.md | 2 +- docs/lessons/classic-beatbox.md | 4 ++-- docs/lessons/compass.md | 4 ++-- docs/lessons/compass/challenges.md | 2 +- docs/lessons/counter/quiz-answers.md | 4 ++-- docs/lessons/counter/quiz.md | 2 +- docs/lessons/dice-roll.md | 4 ++-- docs/lessons/dice-roll/challenges.md | 4 ++-- docs/lessons/dice-roll/quiz-answers.md | 2 +- docs/lessons/dice-roll/quiz.md | 2 +- docs/lessons/game-of-chance.md | 2 +- docs/lessons/glowing-pendulum/quiz-answers.md | 2 +- docs/lessons/glowing-pendulum/quiz.md | 2 +- docs/lessons/glowing-pendulum/tutorial.md | 4 ++-- docs/lessons/graphics.md | 10 ++++---- docs/lessons/guess-the-number.md | 2 +- docs/lessons/guess-the-number/quiz-answers.md | 4 ++-- docs/lessons/happy-birthday.md | 8 +++---- docs/lessons/headbands.md | 6 ++--- docs/lessons/looper/quiz-answers.md | 4 ++-- docs/lessons/love-meter.md | 2 +- docs/lessons/love-meter/activity.md | 2 +- docs/lessons/magic-8.md | 2 +- docs/lessons/magic-8/quiz-answers.md | 2 +- docs/lessons/magic-8/quiz.md | 2 +- docs/lessons/magic-logo/quiz-answers.md | 4 ++-- docs/lessons/magic-logo/quiz.md | 4 ++-- docs/lessons/night-light.md | 2 +- docs/lessons/night-light/quiz-answers.md | 6 ++--- docs/lessons/night-light/quiz.md | 8 +++---- docs/lessons/pogo/activity.md | 6 ++--- .../rotation-animation/quiz-answers.md | 2 +- docs/lessons/seismograph/activity.md | 2 +- docs/lessons/seismograph/challenge.md | 2 +- docs/lessons/snowflake-fall/activity.md | 2 +- docs/lessons/speed-button.md | 2 +- docs/lessons/speed-button/quiz-answers.md | 6 ++--- docs/lessons/spinner.md | 4 ++-- docs/lessons/spinner/quiz-answers.md | 2 +- docs/lessons/spinner/quiz.md | 2 +- docs/lessons/stem.md | 8 +++---- docs/lessons/teach.md | 8 +++---- docs/lessons/temperature.md | 2 +- docs/lessons/truth-or-dare.md | 4 ++-- docs/lessons/truth-or-dare/activity.md | 2 +- docs/lessons/truth-or-dare/quiz-answers.md | 2 +- docs/lessons/truth-or-dare/quiz.md | 2 +- docs/lessons/truth-or-dare/tutorial.md | 2 +- docs/lessons/variables.md | 4 ++-- docs/lessons/zoomer/quiz-answers.md | 4 ++-- docs/lessons/zoomer/quiz.md | 2 +- docs/projects/rock-paper-scissors.md | 4 ++-- docs/reference/basic/forever.md | 2 +- docs/reference/basic/show-animation.md | 2 +- docs/reference/bluetooth/about-bluetooth.md | 6 ++--- docs/reference/bluetooth/bluetooth-pairing.md | 4 ++-- docs/reference/control/reset.md | 2 +- docs/reference/devices.md | 2 +- docs/reference/devices/on-gamepad-button.md | 4 ++-- docs/reference/devices/on-notified.md | 4 ++-- .../devices/on-signal-strength-changed.md | 4 ++-- docs/reference/devices/raise-alert-to.md | 4 ++-- docs/reference/devices/signal-strength.md | 4 ++-- docs/reference/devices/tell-camera-to.md | 4 ++-- .../devices/tell-remote-control-to.md | 4 ++-- docs/reference/event-handler.md | 2 +- docs/reference/images/plot-frame.md | 2 +- docs/reference/images/plot-image.md | 2 +- docs/reference/images/show-frame.md | 2 +- docs/reference/input/light-level.md | 2 +- docs/reference/input/on-button-pressed.md | 2 +- docs/reference/input/on-pin-pressed.md | 4 ++-- docs/reference/input/on-pin-released.md | 4 ++-- docs/reference/input/pin-is-pressed.md | 4 ++-- docs/reference/input/rotation.md | 4 ++-- docs/reference/input/temperature.md | 2 +- docs/reference/led/plot-bar-graph.md | 2 +- docs/reference/led/plot-leds.md | 2 +- docs/reference/out-of-bounds.md | 2 +- docs/reference/pins/servo-set-pulse.md | 2 +- docs/reference/pins/servo-write-pin.md | 2 +- docs/reference/pins/set-pull.md | 2 +- docs/reference/types.md | 2 +- docs/reference/types/string.md | 2 +- olddocs/js/compiler.md | 6 ++--- olddocs/js/contents.md | 8 +++---- olddocs/js/event-handler.md | 2 +- olddocs/js/events.md | 2 +- olddocs/js/gallery.md | 18 +++++++------- olddocs/js/games.md | 12 +++++----- olddocs/js/hourofcode.md | 10 ++++---- olddocs/js/hourofcode/notes.md | 10 ++++---- olddocs/js/lessons.md | 18 +++++++------- .../js/lessons/2-player-pong/quiz-answers.md | 2 +- olddocs/js/lessons/2-player-pong/quiz.md | 2 +- olddocs/js/lessons/digital-pet.md | 2 +- .../js/lessons/digital-pet/quiz-answers.md | 2 +- olddocs/js/lessons/digital-pet/quiz.md | 2 +- .../js/lessons/flipping-bird/quiz-answers.md | 4 ++-- olddocs/js/lessons/flipping-bird/quiz.md | 6 ++--- olddocs/js/lessons/hack-your-headphones.md | 6 ++--- olddocs/js/lessons/letter-up.md | 2 +- .../js/lessons/number-psych/quiz-answers.md | 2 +- olddocs/js/lessons/number-psych/quiz.md | 2 +- olddocs/js/lessons/screen-wipe/activity.md | 6 ++--- .../js/lessons/screen-wipe/quiz-answers.md | 6 ++--- olddocs/js/lessons/screen-wipe/quiz.md | 6 ++--- olddocs/js/lessons/transformer/quiz.md | 2 +- olddocs/js/quick-start.md | 6 ++--- olddocs/js/reactive.md | 24 +++++++++---------- olddocs/js/serial-library.md | 4 ++-- olddocs/js/showcase.md | 2 +- olddocs/js/simulator.md | 18 +++++++------- olddocs/js/string-functions.md | 2 +- olddocs/js/string.md | 2 +- olddocs/js/types.md | 2 +- 132 files changed, 271 insertions(+), 271 deletions(-) diff --git a/docs/docs.md b/docs/docs.md index be6b9f5d..5e50a8c5 100644 --- a/docs/docs.md +++ b/docs/docs.md @@ -8,10 +8,10 @@ * [Projects](/projects) * [Lessons](/lessons) -### Micro:bit reference +### @boardname@ reference -* [The micro:bit APIs](/reference) -* [The micro:bit device](/device) +* [The @boardname@ APIs](/reference) +* [The @boardname@ device](/device) ### Language and data reference diff --git a/docs/getting-started.md b/docs/getting-started.md index 75ddeb0f..96e7a110 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -35,7 +35,7 @@ When this program runs, you will see a smiley face, then a blank screen, then a smiley again -- it never stops! (That's because of the ``forever`` block.) -Click **Download** to move your program to the BBC micro:bit! +Click **Download** to move your program to the @boardname@! Make sure to follow the instructions. ### ~button /getting-started/screen diff --git a/docs/getting-started/buttons.md b/docs/getting-started/buttons.md index 438e9a3a..2f8debe0 100644 --- a/docs/getting-started/buttons.md +++ b/docs/getting-started/buttons.md @@ -18,11 +18,11 @@ input.onButtonPressed(Button.A, () => { #### ~hint The ``showString`` block can show letters, numbers, and punctuation -on the micro:bit screen. +on the @boardname@ screen. #### ~ -Now try to unscramble these blocks in the editor so that the micro:bit +Now try to unscramble these blocks in the editor so that the @boardname@ shows **BANANA** when you press button `B`. ```shuffle @@ -37,7 +37,7 @@ You can find the letter `B` by clicking the letter `A` on the #### ~ -Click **Download** to move your program to the BBC micro:bit! +Click **Download** to move your program to the BBC @boardname@! #### Your turn! @@ -65,7 +65,7 @@ input.onPinPressed(TouchPin.P0, () => { . . # . .`); }); ``` -Click **Download** to move your program to the BBC micro:bit! +Click **Download** to move your program to the @boardname@! ## ~hint diff --git a/docs/getting-started/coin-flipper.md b/docs/getting-started/coin-flipper.md index 93d27c0f..d9b5425f 100644 --- a/docs/getting-started/coin-flipper.md +++ b/docs/getting-started/coin-flipper.md @@ -4,7 +4,7 @@ Are you trying to choose whether to play soccer or go to the movies instead, or which toppings to have on your pizza? Build a coin -flipping machine with the BBC micro:bit to choose for you! +flipping machine with the @boardname@ to choose for you! ### ~ diff --git a/docs/getting-started/rock-paper-scissors.md b/docs/getting-started/rock-paper-scissors.md index a4e8395a..72216c93 100644 --- a/docs/getting-started/rock-paper-scissors.md +++ b/docs/getting-started/rock-paper-scissors.md @@ -2,7 +2,7 @@ ### ~avatar avatar -Build a Rock Paper Scissors game with the BBC micro:bit! You can play +Build a Rock Paper Scissors game with the @boardname@! 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. (The game is built like a coin flipper, but with three choices instead of two.) @@ -152,7 +152,7 @@ That's why you can use an ``else`` instead of an ``else if``. Your game is ready! -Click **Download** to move your program to the BBC micro:bit! +Click **Download** to move your program to the @boardname@! Have fun! @@ -198,7 +198,7 @@ input.onButtonPressed(Button.B, () => { basic.showNumber(game.score()) }) ``` -Click **Download** to move your program to the BBC micro:bit! +Click **Download** to move your program to the @boardname@! ### ~button /projects NEXT: PROJECTS! diff --git a/docs/getting-started/screen.md b/docs/getting-started/screen.md index 24dc158b..ecf48b29 100644 --- a/docs/getting-started/screen.md +++ b/docs/getting-started/screen.md @@ -32,7 +32,7 @@ basic.forever(() => { `) }); ``` -Click **Download** to move your program to the BBC micro:bit! +Click **Download** to move your program to the @boardname@! ### Your turn! @@ -85,7 +85,7 @@ basic.forever(() => { `) }); ``` -Click **Download** to move your program to the BBC micro:bit! +Click **Download** to move your program to the @boardname@! #### ~hint diff --git a/docs/getting-started/shake.md b/docs/getting-started/shake.md index 9996f03b..f24ca9e1 100644 --- a/docs/getting-started/shake.md +++ b/docs/getting-started/shake.md @@ -1,6 +1,6 @@ # Shake -You can find when someone is shaking the BBC micro:bit by checking its +You can find when someone is shaking the @boardname@ by checking its **accelerometer** (it finds whether the micro:bit is speeding up or slowing down). @@ -17,7 +17,7 @@ input.onGesture(Gesture.Shake, () => { # . . . #`); }); ``` -Click **Download** to move your program to the BBC micro:bit! +Click **Download** to move your program to the @boardname@! ### ~button /getting-started/coin-flipper NEXT: COIN FLIPPER GAME diff --git a/docs/lessons.md b/docs/lessons.md index 8c26b467..b52d573f 100644 --- a/docs/lessons.md +++ b/docs/lessons.md @@ -28,7 +28,7 @@ ## Intermediate -* [Magic 8](/lessons/magic-8), a fortune teller game with the BBC micro:bit +* [Magic 8](/lessons/magic-8), a fortune teller game with the @boardname@ * [Guess the Number](/lessons/guess-the-number), guess a random number with pick number * [Counter](/lessons/counter), display a number with a variable * [Love Meter](/lessons/love-meter), create a love meter with on pin pressed @@ -40,7 +40,7 @@ * [Temperature](/lessons/temperature), get the ambient temperature (degree Celsius °C) * [Digi Yoyo](/lessons/digi-yoyo), create a counter with a while loop * [Rotation Animation](/lessons/rotation-animation), control an animation with a boolean variable -* [Compass](/lessons/compass), displays the direction the BBC micro:bit is pointing with compass +* [Compass](/lessons/compass), displays the direction the @boardname@ is pointing with compass * [Zoomer](/lessons/zoomer), measure the force with acceleration * [Glowing Pendulum](/lessons/glowing-pendulum), construct a pendulum that glows using acceleration * [Classic Beatbox](/lessons/classic-beatbox), make a beatbox music player with variables @@ -60,7 +60,7 @@ * [Prank WiFi](/lessons/prank-wifi), create fake WiFi to trick your friends * [Speed Button](/lessons/speed-button), code a speed game with running time * [Headbands](/lessons/headbands), create a charades game with a collection of strings that hold the words -* [Hero](/lessons/hero), reconstruct the classic arcade game pac man with the BBC micro:bit +* [Hero](/lessons/hero), reconstruct the classic arcade game pac man with the @boardname@ * [Catch the Egg](/lessons/catch-the-egg-game), catch falling eggs in a basket with an acceleration controller ### ~ diff --git a/docs/lessons/answering-machine.md b/docs/lessons/answering-machine.md index 51d47eab..50204cdc 100644 --- a/docs/lessons/answering-machine.md +++ b/docs/lessons/answering-machine.md @@ -1,6 +1,6 @@ # answering machine blocks lesson -Create an answering machine on the BBC micro:bit +Create an answering machine on the @boardname@ ## Topic diff --git a/docs/lessons/beautiful-image.md b/docs/lessons/beautiful-image.md index 8bb450d9..f59fbfd5 100644 --- a/docs/lessons/beautiful-image.md +++ b/docs/lessons/beautiful-image.md @@ -1,6 +1,6 @@ # beautiful image lesson -Display beautiful images on the BBC micro:bit. +Display beautiful images on the @boardname@. ## Topic @@ -14,7 +14,7 @@ Show LEDs ## Prior learning/place of lesson in scheme of work -Learn how to **show LEDs**, to show an image on the BBC micro:bit's LED screen. We will be learning how to Show LEDs using simple commands such as Show LEDs and pause. +Learn how to **show LEDs**, to show an image on the @boardname@'s LED screen. We will be learning how to Show LEDs using simple commands such as Show LEDs and pause. ## Documentation diff --git a/docs/lessons/blocks-conditions.md b/docs/lessons/blocks-conditions.md index 55286ca0..59a61977 100644 --- a/docs/lessons/blocks-conditions.md +++ b/docs/lessons/blocks-conditions.md @@ -4,19 +4,19 @@ An introduction to conditions for the Block Editor. ## Introduction to conditions -In the introduction to code, we made the BBC micro:bit automatically shows the message ‘hello world!’: +In the introduction to code, we made the @boardname@ automatically shows the message ‘hello world!’: ```blocks basic.showString("hello world!") ``` -This statement, or code, will happen as soon as the BBC micro:bit is activated. This means it is unconditional. We can add a condition to make code function in certain ways: +This statement, or code, will happen as soon as the @boardname@ is activated. This means it is unconditional. We can add a condition to make code function in certain ways: * A calculator waits for the user in input numbers and a function, before outputting a result * A game waits for the user to press a button at the right time before outputting their score * A quiz waits for the user to choose the correct option, and if they are wrong the quiz will tell the user -In programming we use an ‘if’ statement: if this condition is met, do something. Lets add an if statement to the code we had before; the BBC Micro:bit will wait for the user to press a button before showing the image. +In programming we use an ‘if’ statement: if this condition is met, do something. Lets add an if statement to the code we had before; the @boardname@ will wait for the user to press a button before showing the image. ```blocks basic.forever(() => { @@ -40,9 +40,9 @@ You could now add additional conditions to your 'if statement'. Here are some id What if the user does not press a button? What if the user presses the wrong button? We call this an else, because if the criteria of the if statement are not met then something else is done. -For example, we could make it so our BBC Micro:bit tells us to press the A button. Remove the `button pressed` and `show string` blocks from the `if` block and right click it and select **Delete**. Now click the **If** category and drag out an `else if` block. Plug the `button pressed` and `show string` blocks in the correct places. +For example, we could make it so our @boardname@ tells us to press the A button. Remove the `button pressed` and `show string` blocks from the `if` block and right click it and select **Delete**. Now click the **If** category and drag out an `else if` block. Plug the `button pressed` and `show string` blocks in the correct places. -We want the message "Press A!" to scroll across the BBC micro:bit, so right-click the `show string` block and select **Duplicate**. Drag this new block into the `else` section and replace the “hello, world!” with "Press A!". Your code should look like this: +We want the message "Press A!" to scroll across the @boardname@, so right-click the `show string` block and select **Duplicate**. Drag this new block into the `else` section and replace the “hello, world!” with "Press A!". Your code should look like this: ```blocks basic.forever(() => { @@ -54,7 +54,7 @@ basic.forever(() => { }) ``` -So, to recap: the `forever` block makes sure our code runs forever. The BBC micro:bit checks if the user is pressing the left button, if the user is not then the “Press the button!” message will scroll across the LEDs. If the user is pressing the button then the “hello, world!” message will scroll across the screen. Check this in the simulator or attach the BBC micro:bit to the computer then click **Download** to send the code onto the BBC micro:bit. +So, to recap: the `forever` block makes sure our code runs forever. The @boardname@ checks if the user is pressing the left button, if the user is not then the “Press the button!” message will scroll across the LEDs. If the user is pressing the button then the “hello, world!” message will scroll across the screen. Check this in the simulator or attach the @boardname@ to the computer then click **Download** to send the code onto the @boardname@. ## What is a condition? diff --git a/docs/lessons/bop-it/activity.md b/docs/lessons/bop-it/activity.md index 44d3093d..15e63b9e 100644 --- a/docs/lessons/bop-it/activity.md +++ b/docs/lessons/bop-it/activity.md @@ -1,6 +1,6 @@ # bop it challenges -a game similar to "Simon Says" with the BBC micro:bit. +a game similar to "Simon Says" with the @boardname@. ## Before we get started diff --git a/docs/lessons/bop-it/quiz-answers.md b/docs/lessons/bop-it/quiz-answers.md index 66033d7e..73b09b56 100644 --- a/docs/lessons/bop-it/quiz-answers.md +++ b/docs/lessons/bop-it/quiz-answers.md @@ -45,7 +45,7 @@ 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 +## 5. Write the code that increments the score if the @boardname@ logo is tilted down when the global variable called 'action' is equal to 1 ```blocks input.onLogoDown(() => { @@ -65,7 +65,7 @@ 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 +## 7. Write the code that increments the score if the @boardname@ is shaken when the global variable called 'action' is equal to 2 ```blocks input.onLogoDown(() => { diff --git a/docs/lessons/bop-it/quiz.md b/docs/lessons/bop-it/quiz.md index 5cdc2b68..5c4f1df5 100644 --- a/docs/lessons/bop-it/quiz.md +++ b/docs/lessons/bop-it/quiz.md @@ -26,7 +26,7 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
-### 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 +### 5. Write the code that increments the score if the @boardname@ logo is tilted down when the global variable called 'action' is equal to 1
@@ -34,5 +34,5 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
-### 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 +### 7. Write the code that increments the score if the @boardname@ is shaken when the global variable called 'action' is equal to 2 diff --git a/docs/lessons/catch-the-egg-game.md b/docs/lessons/catch-the-egg-game.md index 1e66afbc..3ae81c25 100644 --- a/docs/lessons/catch-the-egg-game.md +++ b/docs/lessons/catch-the-egg-game.md @@ -47,5 +47,5 @@ game.removeLife(1); * learn how to return the larger of two numbers * learn how to return a random number * learn how to return the modulus -* learn how to show a number of the BBC micro:bit screen +* learn how to show a number of the @boardname@ screen * learn how to pause your code for the specified number of milliseconds diff --git a/docs/lessons/catch-the-egg-game/quiz-answers.md b/docs/lessons/catch-the-egg-game/quiz-answers.md index 08ceeb78..265b8706 100644 --- a/docs/lessons/catch-the-egg-game/quiz-answers.md +++ b/docs/lessons/catch-the-egg-game/quiz-answers.md @@ -43,7 +43,7 @@ eggY = eggY + 1 led.plot(eggX, eggY) ``` -## 4. . Write the code that resets the egg after it has fallen past the bottom of the BBC micro:bit. +## 4. . Write the code that resets the egg after it has fallen past the bottom of the @boardname@.
diff --git a/docs/lessons/catch-the-egg-game/quiz.md b/docs/lessons/catch-the-egg-game/quiz.md index b4939c20..bcd13a77 100644 --- a/docs/lessons/catch-the-egg-game/quiz.md +++ b/docs/lessons/catch-the-egg-game/quiz.md @@ -24,7 +24,7 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
-## 4. Write the code that resets the egg after it has fallen past the bottom of the BBC micro:bit. +## 4. Write the code that resets the egg after it has fallen past the bottom of the @boardname@.
diff --git a/docs/lessons/classic-beatbox.md b/docs/lessons/classic-beatbox.md index 7edf6526..80ae0764 100644 --- a/docs/lessons/classic-beatbox.md +++ b/docs/lessons/classic-beatbox.md @@ -1,6 +1,6 @@ # classic beatbox -display beautiful images on the BBC micro:bit. +display beautiful images on the @boardname@. ## Topic @@ -19,5 +19,5 @@ Learn how to make a beatbox music player using pins P1 and P2. We will be learni ## Objectives -* learn how to code music on the BBC micro:bit +* learn how to code music on the @boardname@ diff --git a/docs/lessons/compass.md b/docs/lessons/compass.md index 6348e0e6..83ee8502 100644 --- a/docs/lessons/compass.md +++ b/docs/lessons/compass.md @@ -1,6 +1,6 @@ # compass lesson -create a die on the BBC micro:bit. +create a die on the @boardname@. ## Topic @@ -36,7 +36,7 @@ basic.showLeds(` ## Objectives -* learn how to run code when the BBC micro:bit is shaken, when running code in the web browser, moving the mouse quickly simulates shaking +* learn how to run code when the @boardname@ is shaken, when running code in the web browser, moving the mouse quickly simulates shaking * learn how to create a local variable as a place where you can store and retrieve data * learn how the assignment operator is used to declare a new local variable * learn how to declare a new local variable or update the value of a variable diff --git a/docs/lessons/compass/challenges.md b/docs/lessons/compass/challenges.md index 172d4986..ac3a6055 100644 --- a/docs/lessons/compass/challenges.md +++ b/docs/lessons/compass/challenges.md @@ -27,7 +27,7 @@ basic.forever(() => { ### Challenge 1 -Instead of displaying `N` when the BBC micro:bit is pointing North, display a star to indicate the north star. +Instead of displaying `N` when the @boardname@ is pointing North, display a star to indicate the north star. ```blocks let degrees = 0; diff --git a/docs/lessons/counter/quiz-answers.md b/docs/lessons/counter/quiz-answers.md index c281afd0..0ab491d7 100644 --- a/docs/lessons/counter/quiz-answers.md +++ b/docs/lessons/counter/quiz-answers.md @@ -1,6 +1,6 @@ # counter quiz answers -Learn how to create a counter with the BBC micro:bit button. +Learn how to create a counter with the @boardname@ button. This is the answer key for the [counter quiz](/lessons/counter/quiz). @@ -48,7 +48,7 @@ input.onButtonPressed(Button.A, () => { ![](/static/mb/lessons/counter-2.png) -We included the code ``on button pressed("A")`` that runs each time the user presses A. The code increments `count` by `1`. We increase `count` by 1 whenever the user presses the button. So the third time the A button is pressed on the BBC micro:bit, the number 3 is displayed +We included the code ``on button pressed("A")`` that runs each time the user presses A. The code increments `count` by `1`. We increase `count` by 1 whenever the user presses the button. So the third time the A button is pressed on the @boardname@, the number 3 is displayed
diff --git a/docs/lessons/counter/quiz.md b/docs/lessons/counter/quiz.md index 745d81f0..28cb3737 100644 --- a/docs/lessons/counter/quiz.md +++ b/docs/lessons/counter/quiz.md @@ -1,6 +1,6 @@ # counter quiz -Learn how to create a counter with the BBC micro:bit button. +Learn how to create a counter with the @boardname@ button. ## Name diff --git a/docs/lessons/dice-roll.md b/docs/lessons/dice-roll.md index c0f13b95..8e13aac3 100644 --- a/docs/lessons/dice-roll.md +++ b/docs/lessons/dice-roll.md @@ -1,6 +1,6 @@ # dice roll lesson -Create a dice on the BBC micro:bit. +Create a dice on the @boardname@. ## Topic @@ -35,7 +35,7 @@ basic.showLeds(` ## Objectives -* learn how to run code when the BBC micro:bit is shaken, when running code in the web browser, moving the mouse quickly simulates shaking +* learn how to run code when the @boardname@ is shaken, when running code in the web browser, moving the mouse quickly simulates shaking * learn how to create a local variable as a place where you can store and retrieve data * learn how the assignment operator is used to declare a new local variable * learn how to declare a new local variable or update the value of a variable diff --git a/docs/lessons/dice-roll/challenges.md b/docs/lessons/dice-roll/challenges.md index 1a3d0bbd..10672e74 100644 --- a/docs/lessons/dice-roll/challenges.md +++ b/docs/lessons/dice-roll/challenges.md @@ -121,7 +121,7 @@ input.onGesture(Gesture.Shake, () => { ### Challenge 2 -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. +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 @boardname@. ```blocks input.onGesture(Gesture.Shake, () => { @@ -179,5 +179,5 @@ input.onGesture(Gesture.Shake, () => { ### Challenge 3 -Add a couple more conditions so that the BBC micro:bit randomly chooses a number between 1 and 8. +Add a couple more conditions so that the @boardname@ randomly chooses a number between 1 and 8. diff --git a/docs/lessons/dice-roll/quiz-answers.md b/docs/lessons/dice-roll/quiz-answers.md index fa87d611..60696356 100644 --- a/docs/lessons/dice-roll/quiz-answers.md +++ b/docs/lessons/dice-roll/quiz-answers.md @@ -1,6 +1,6 @@ # dice roll quiz answers -Create a dice when the BBC micro:bit is shaken +Create a dice when the @boardname@ is shaken These are the answers to the [dice roll quiz](/lessons/dice-roll/quiz). diff --git a/docs/lessons/dice-roll/quiz.md b/docs/lessons/dice-roll/quiz.md index b4afaf28..d9b58df2 100644 --- a/docs/lessons/dice-roll/quiz.md +++ b/docs/lessons/dice-roll/quiz.md @@ -1,6 +1,6 @@ # dice roll quiz -Create a dice when the BBC micro:bit is shaken +Create a dice when the @boardname@ is shaken ## Name diff --git a/docs/lessons/game-of-chance.md b/docs/lessons/game-of-chance.md index 52f88d64..b19fe9f8 100644 --- a/docs/lessons/game-of-chance.md +++ b/docs/lessons/game-of-chance.md @@ -1,6 +1,6 @@ # game of chance blocks lesson -create an answering machine on the BBC micro:bit +create an answering machine on the @boardname@ ## Topic diff --git a/docs/lessons/glowing-pendulum/quiz-answers.md b/docs/lessons/glowing-pendulum/quiz-answers.md index 3643cc4f..fb9f6425 100644 --- a/docs/lessons/glowing-pendulum/quiz-answers.md +++ b/docs/lessons/glowing-pendulum/quiz-answers.md @@ -33,7 +33,7 @@ let acceleration = input.acceleration(Dimension.X) let accelerationAbsolute = Math.abs(acceleration) ``` -## 4. Write the code to use the acceleration value from question 3 to set the brightness on the BBC micro:bit. +## 4. Write the code to use the acceleration value from question 3 to set the brightness on the @boardname@.
diff --git a/docs/lessons/glowing-pendulum/quiz.md b/docs/lessons/glowing-pendulum/quiz.md index 07cf3337..f7448441 100644 --- a/docs/lessons/glowing-pendulum/quiz.md +++ b/docs/lessons/glowing-pendulum/quiz.md @@ -22,6 +22,6 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
-## 4. Write the code to include acceleration value question 3 to set the brightness on the BBC micro:bit. +## 4. Write the code to include acceleration value question 3 to set the brightness on the @boardname@. diff --git a/docs/lessons/glowing-pendulum/tutorial.md b/docs/lessons/glowing-pendulum/tutorial.md index 1bc261d5..b0640bd9 100644 --- a/docs/lessons/glowing-pendulum/tutorial.md +++ b/docs/lessons/glowing-pendulum/tutorial.md @@ -1,12 +1,12 @@ # glowing pendulum block tutorial -The glowing pendulum changes the screen brightness based on the acceleration measured on the BBC micro:bit. +The glowing pendulum changes the screen brightness based on the acceleration measured on the @boardname@. ### 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 +* the @boardname@ 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` diff --git a/docs/lessons/graphics.md b/docs/lessons/graphics.md index 3ce1fd05..2c003095 100644 --- a/docs/lessons/graphics.md +++ b/docs/lessons/graphics.md @@ -4,13 +4,13 @@ An introduction to graphics for the Block Editor. ## Before we get started -Ensure you have completed the 'Hello, world!' and Loop tutorials and tested them on a simulator or on BBC micro:bit. +Ensure you have completed the 'Hello, world!' and Loop tutorials and tested them on a simulator or on @boardname@. ```blocks basic.showString("HI!"); ``` -The BBC micro:bit has a grid of 25 LEDs, so we can use these to display images. +The @boardname@ has a grid of 25 LEDs, so we can use these to display images. We’ve already experimented with the `show string` block that displays a string (some text) that we program it to. However we can use more blocks from the **Images** drawer to render or display images in different ways. @@ -22,7 +22,7 @@ We can draw little images from the LEDs by ticking boxes. Drag a `show image` bl ### Plotting points -We can also code our bug to plot a point by giving an x (horizontal) and y (vertical) coordinates, from 0 to 4. Click the **LED** drawer and drag a `plot` block. Try changing the coordinates and see the effect this has on the BBC micro:bit. +We can also code our bug to plot a point by giving an x (horizontal) and y (vertical) coordinates, from 0 to 4. Click the **LED** drawer and drag a `plot` block. Try changing the coordinates and see the effect this has on the @boardname@. We can also unplot a point (turn the LED off again) using the `unplot` block. So we could create a flashing LED program, using the `pause` block to create a delay. @@ -43,7 +43,7 @@ The pause block is in milliseconds, so setting it to 1000 will have a pause of a ### Devising algorithms for shapes -An algorithm is a set of steps to follow to solve a problem. We can begin to draw shapes on the BBC micro:bit using an algorithm. +An algorithm is a set of steps to follow to solve a problem. We can begin to draw shapes on the @boardname@ using an algorithm. For example, we could draw a straight line with this code: ```blocks @@ -70,7 +70,7 @@ basic.forever(() => { Animations are changes happening at a certain rate. For example, we could add the `pause` block from the **Basic** drawer with our square algorithm – this will slowly draw a square (as an animation). -We could create more complex animations, for example we could make our BBC micro:bit display an explosion or fireworks. +We could create more complex animations, for example we could make our @boardname@ display an explosion or fireworks. ### Image variables diff --git a/docs/lessons/guess-the-number.md b/docs/lessons/guess-the-number.md index 37beeb7a..d383300c 100644 --- a/docs/lessons/guess-the-number.md +++ b/docs/lessons/guess-the-number.md @@ -16,7 +16,7 @@ Math - Pick Random ## Prior learning/place of lesson in scheme of work -Learn how to create numbers randomly by using the input of the BBC micro:bit. We will be learning how to create random numbers with input using a local variable as well as simple commands, such as pick number and show number. +Learn how to create numbers randomly by using the input of the @boardname@. We will be learning how to create random numbers with input using a local variable as well as simple commands, such as pick number and show number. ## Documentation diff --git a/docs/lessons/guess-the-number/quiz-answers.md b/docs/lessons/guess-the-number/quiz-answers.md index a417ea02..7c2b019a 100644 --- a/docs/lessons/guess-the-number/quiz-answers.md +++ b/docs/lessons/guess-the-number/quiz-answers.md @@ -10,7 +10,7 @@ Answers may vary. Generally, on button pressed run code when an input button is ## 2. Consider the following directions -Write the line of code that creates a condition when the BBC micro:bit button A is pressed. +Write the line of code that creates a condition when the @boardname@ button A is pressed. ```blocks @@ -28,7 +28,7 @@ let randomNumber = Math.random(10) ``` ## 4. -If the rectangle below represents the BBC micro:bit, shade the areas that will be displayed. Explain why that particular area is shaded. +If the rectangle below represents the @boardname@, shade the areas that will be displayed. Explain why that particular area is shaded. ```blocks let randomNumber = Math.random(10) diff --git a/docs/lessons/happy-birthday.md b/docs/lessons/happy-birthday.md index e9c54de5..aaadd41b 100644 --- a/docs/lessons/happy-birthday.md +++ b/docs/lessons/happy-birthday.md @@ -1,6 +1,6 @@ # happy birthday blocks lesson -display beautiful images on the BBC micro:bit. +display beautiful images on the @boardname@. ## Topic @@ -13,10 +13,10 @@ Music ## Prior learning/place of lesson in scheme of work -Learn how to convert your BBC micro:bit into a music player using pins P0 and GND, earphones (or speakers), as well as crocodile clips (or spring clips). +Learn how to convert your @boardname@ into a music player using pins P0 and GND, earphones (or speakers), as well as crocodile clips (or spring clips). We will be learning how to code musical notes using simple commands such as play, keys, and notes. ## Objectives -* learn how to code music on the BBC micro:bit -* learn how to setup the BBC micro:bit as a music player +* learn how to code music on the @boardname@ +* learn how to setup the @boardname@ as a music player diff --git a/docs/lessons/headbands.md b/docs/lessons/headbands.md index 14c7716d..eba4675e 100644 --- a/docs/lessons/headbands.md +++ b/docs/lessons/headbands.md @@ -61,10 +61,10 @@ Learn how to create a charades game with **collections**, ` create -> Collection * learn how to create a global variable as a place where you can store data so that you can use it later in your code, accessible across functions and in nested code blocks * learn how to repeat code in the background forever * learn how to learn how to conditionally run code depending on whether a condition is true or not -* learn how to run code when the BBC micro:bit is oriented perpendicular to the floor with the logo down +* learn how to run code when the @boardname@ is oriented perpendicular to the floor with the logo down * learn how to get the number of milliseconds elapsed since the script began -* learn how to show a string on the BBC micro:bit screen -* learn how to show a number of the BBC micro:bit screen +* learn how to show a string on the @boardname@ screen +* learn how to show a number of the @boardname@ screen ## Links to the National Curriculum Programmes of Study for Computing diff --git a/docs/lessons/looper/quiz-answers.md b/docs/lessons/looper/quiz-answers.md index aa4fa1b8..251ed688 100644 --- a/docs/lessons/looper/quiz-answers.md +++ b/docs/lessons/looper/quiz-answers.md @@ -16,7 +16,7 @@ for (let i = 0; i < 4; i++) { } ``` -If the rectangle below represents the BBC micro:bit, shade the areas that will be displayed. Explain why that particular area is shaded. +If the rectangle below represents the @boardname@, shade the areas that will be displayed. Explain why that particular area is shaded. Let's create a for loop where `0` is the loop's starting value, `i` is the index variable, and `4` 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 = 4`. @@ -30,7 +30,7 @@ for (let i1 = 0; i1 < 6; i1++) { } ``` -If the rectangle below represents the BBC micro:bit, shade the areas that will be displayed. Explain why that particular area is shaded. +If the rectangle below represents the @boardname@, shade the areas that will be displayed. Explain why that particular area is shaded. Let's create a for loop where `0` is the loop's starting value, `i` is the index variable, and `6` 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 = 6`. diff --git a/docs/lessons/love-meter.md b/docs/lessons/love-meter.md index 822b4205..1c0ef508 100644 --- a/docs/lessons/love-meter.md +++ b/docs/lessons/love-meter.md @@ -1,6 +1,6 @@ # love meter blocks lesson -Create a love meter with the BBC micro:bit. +Create a love meter with the @boardname@. ## Topic diff --git a/docs/lessons/love-meter/activity.md b/docs/lessons/love-meter/activity.md index 687592a7..b19f59e7 100644 --- a/docs/lessons/love-meter/activity.md +++ b/docs/lessons/love-meter/activity.md @@ -28,7 +28,7 @@ input.onPinPressed(TouchPin.P0, () => { ``` -Finally, let's show that number on the micro:bit. You are registering an event handler that will execute on the BBC micro:bit whenever the user holds the GND pin with one hand, and presses pin 0 with the other hand, thus completing a circuit +Finally, let's show that number on the micro:bit. You are registering an event handler that will execute on the @boardname@ whenever the user holds the GND pin with one hand, and presses pin 0 with the other hand, thus completing a circuit ```blocks diff --git a/docs/lessons/magic-8.md b/docs/lessons/magic-8.md index 32e0d573..0a706cf0 100644 --- a/docs/lessons/magic-8.md +++ b/docs/lessons/magic-8.md @@ -1,6 +1,6 @@ # magic 8 lesson -a fortune teller game with the BBC micro:bit. +a fortune teller game with the @boardname@. ## Topic diff --git a/docs/lessons/magic-8/quiz-answers.md b/docs/lessons/magic-8/quiz-answers.md index 3ae49582..7ba2706e 100644 --- a/docs/lessons/magic-8/quiz-answers.md +++ b/docs/lessons/magic-8/quiz-answers.md @@ -1,6 +1,6 @@ # magic 8 quiz answers -create a magic 8 ball on the BBC micro:bit. +create a magic 8 ball on the @boardname@. ## Name diff --git a/docs/lessons/magic-8/quiz.md b/docs/lessons/magic-8/quiz.md index 64a99c9c..cee797c7 100644 --- a/docs/lessons/magic-8/quiz.md +++ b/docs/lessons/magic-8/quiz.md @@ -1,6 +1,6 @@ # magic 8 quiz -create a magic 8 ball on the BBC micro:bit. +create a magic 8 ball on the @boardname@. ## Name diff --git a/docs/lessons/magic-logo/quiz-answers.md b/docs/lessons/magic-logo/quiz-answers.md index 16e5f2bf..8d0324bd 100644 --- a/docs/lessons/magic-logo/quiz-answers.md +++ b/docs/lessons/magic-logo/quiz-answers.md @@ -12,11 +12,11 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu ## 1. Define 'on logo up' -A function that will run code when the BBC micro:bit screen is facing up and vertically orientated. +A function that will run code when the @boardname@ screen is facing up and vertically orientated.
-## 2. Write the condition that detects when the BBC micro:bit logo is facing up and vertically orientated. +## 2. Write the condition that detects when the @boardname@ logo is facing up and vertically orientated. The `logo up` event is raised when... diff --git a/docs/lessons/magic-logo/quiz.md b/docs/lessons/magic-logo/quiz.md index 9f96d248..05b00fab 100644 --- a/docs/lessons/magic-logo/quiz.md +++ b/docs/lessons/magic-logo/quiz.md @@ -12,9 +12,9 @@ Use the hints from the [magic logo activity](/lessons/magic-logo/activity) to an
-## 2. Write the condition that detects when the BBC micro:bit logo is facing up and vertically orientated. +## 2. Write the condition that detects when the @boardname@ logo is facing up and vertically orientated. -## 3. Write the code to display a downward pointing arrow when the BBC micro:bit logo is down. +## 3. Write the code to display a downward pointing arrow when the @boardname@ logo is down. ![](/static/mb/lessons/magic-logo-0.png) diff --git a/docs/lessons/night-light.md b/docs/lessons/night-light.md index 9ee37f63..4916d644 100644 --- a/docs/lessons/night-light.md +++ b/docs/lessons/night-light.md @@ -1,6 +1,6 @@ # night light lesson -change the brightness of the BBC micro:bit. +change the brightness of the @boardname@. ## Topic diff --git a/docs/lessons/night-light/quiz-answers.md b/docs/lessons/night-light/quiz-answers.md index ac517a4e..c3e78702 100644 --- a/docs/lessons/night-light/quiz-answers.md +++ b/docs/lessons/night-light/quiz-answers.md @@ -12,7 +12,7 @@ This function sets the brightness of the LED screen. ![](/static/mb/lessons/night-light-0.png) -If the rectangle above represents the BBC micro:bit, write the code to set all the LEDs to full brightness and to turn on all the LEDs. +If the rectangle above represents the @boardname@, write the code to set all the LEDs to full brightness and to turn on all the LEDs.
@@ -31,7 +31,7 @@ basic.showLeds(` ![](/static/mb/lessons/night-light-1.png) -If the rectangle above represents the BBC micro:bit, write the code to set the screen brightness to 50% (128) and turns on all the LEDs. +If the rectangle above represents the @boardname@, write the code to set the screen brightness to 50% (128) and turns on all the LEDs.
@@ -50,7 +50,7 @@ basic.showLeds(` ![](/static/mb/lessons/night-light-2.png) -If the rectangle above represents the BBC micro:bit, write the code to turn off all the LEDs. +If the rectangle above represents the @boardname@, write the code to turn off all the LEDs. ```blocks led.setBrightness(0) diff --git a/docs/lessons/night-light/quiz.md b/docs/lessons/night-light/quiz.md index 04546039..6153bd26 100644 --- a/docs/lessons/night-light/quiz.md +++ b/docs/lessons/night-light/quiz.md @@ -1,6 +1,6 @@ # night light quiz -change the brightness of the BBC micro:bit. +change the brightness of the @boardname@. ## Name @@ -12,19 +12,19 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu ## 1. Describe what "led->set brightness" does ? -## 2. If the picture below is the BBC micro:bit, write the code that sets all the LEDs to full brightness and turns on all the LEDs +## 2. If the picture below is the @boardname@, write the code that sets all the LEDs to full brightness and turns on all the LEDs ![](/static/mb/lessons/night-light-0.png)
-## 3. If the picture below is the BBC micro:bit, write the code that sets the screen brightness to 50% (128) and turns on all the LEDs. +## 3. If the picture below is the @boardname@, write the code that sets the screen brightness to 50% (128) and turns on all the LEDs. ![](/static/mb/lessons/night-light-1.png)
-## 4. If the picture below is the BBC micro:bit, write the code turns off all the LEDs. +## 4. If the picture below is the @boardname@, write the code turns off all the LEDs. ![](/static/mb/lessons/night-light-2.png) diff --git a/docs/lessons/pogo/activity.md b/docs/lessons/pogo/activity.md index 56c54fea..4861c849 100644 --- a/docs/lessons/pogo/activity.md +++ b/docs/lessons/pogo/activity.md @@ -21,7 +21,7 @@ basic.forever(() => { }) ``` -The function `acceleration(y)` gets the acceleration value (milli g-force), in the `y` dimension. If the `acceleration(y)`is greater than 2000 milli g-force, we will change jumps by 1. If jumping is greater than 2000 milli-gravities, then change jumps by 1 and display a smiley on the BBC micro:bit. Finally, we will remove the smiley image from the screen +The function `acceleration(y)` gets the acceleration value (milli g-force), in the `y` dimension. If the `acceleration(y)`is greater than 2000 milli g-force, we will change jumps by 1. If jumping is greater than 2000 milli-gravities, then change jumps by 1 and display a smiley on the @boardname@. Finally, we will remove the smiley image from the screen ```blocks @@ -42,7 +42,7 @@ basic.forever(() => { }) ``` -Now let's register an event handler that will execute whenever an input button (A) is pressed during program execution. If you press button A, then show the number of jumps greater than 2000 milli-gravities on the BBC micro:bit. +Now let's register an event handler that will execute whenever an input button (A) is pressed during program execution. If you press button A, then show the number of jumps greater than 2000 milli-gravities on the @boardname@. ```blocks let jumps = 0 @@ -65,7 +65,7 @@ input.onButtonPressed(Button.A, () => { }) ``` -If you press button A+B together, then reset the jump counter to 0 on the BBC micro:bit. Finally, we will show the show the jump counter on the micro:bit +If you press button A+B together, then reset the jump counter to 0 on the @boardname@. Finally, we will show the show the jump counter on the micro:bit ```blocks diff --git a/docs/lessons/rotation-animation/quiz-answers.md b/docs/lessons/rotation-animation/quiz-answers.md index 3bccc6eb..b2c76874 100644 --- a/docs/lessons/rotation-animation/quiz-answers.md +++ b/docs/lessons/rotation-animation/quiz-answers.md @@ -45,7 +45,7 @@ while (rotating) { It is a **while** loop that will be executed only if the ** variable** called `rotating` is **true**. -## 4. If the rectangle below represents the BBC micro:bit, shade the areas that will be displayed. Explain why that particular area is shaded. +## 4. If the rectangle below represents the @boardname@, shade the areas that will be displayed. Explain why that particular area is shaded. ```blocks basic.showLeds(` diff --git a/docs/lessons/seismograph/activity.md b/docs/lessons/seismograph/activity.md index 5878cab1..06ffbc05 100644 --- a/docs/lessons/seismograph/activity.md +++ b/docs/lessons/seismograph/activity.md @@ -10,7 +10,7 @@ Engineering: In this project, you will build your own seismograph micro:bit from ## What you'll need: -* BBC micro:bit +* @boardname@ * micro USB cable * Plate * Tape diff --git a/docs/lessons/seismograph/challenge.md b/docs/lessons/seismograph/challenge.md index afd55fbc..71c5a04c 100644 --- a/docs/lessons/seismograph/challenge.md +++ b/docs/lessons/seismograph/challenge.md @@ -11,7 +11,7 @@ Engineering: In this project, you will build a remote control based on the seism ## What you'll need: -* BBC micro:bits (2) +* @boardname@s (2) * micro USB cables (2) * Plate * Tape diff --git a/docs/lessons/snowflake-fall/activity.md b/docs/lessons/snowflake-fall/activity.md index f5cbc842..85d82b10 100644 --- a/docs/lessons/snowflake-fall/activity.md +++ b/docs/lessons/snowflake-fall/activity.md @@ -53,7 +53,7 @@ basic.forever(() => { }) ``` -Run your code in the simulator or download it to your BBC micro:bit to see what happens! +Run your code in the simulator or download it to your @boardname@ to see what happens! ### ~avatar avatar diff --git a/docs/lessons/speed-button.md b/docs/lessons/speed-button.md index 206eea3a..6932cf68 100644 --- a/docs/lessons/speed-button.md +++ b/docs/lessons/speed-button.md @@ -1,6 +1,6 @@ # speed button lesson -code a speed game by declaring Booleans on the BBC micro:bit. +code a speed game by declaring Booleans on the @boardname@. diff --git a/docs/lessons/speed-button/quiz-answers.md b/docs/lessons/speed-button/quiz-answers.md index bc647131..12508865 100644 --- a/docs/lessons/speed-button/quiz-answers.md +++ b/docs/lessons/speed-button/quiz-answers.md @@ -10,7 +10,7 @@ This is the answer key for the [speed button quiz](/lessons/speed-button/quiz). A variable that is available throughout your main function. -## 2. If the rectangle below represents the BBC micro:bit, shade the area that shows the value of the variable count. +## 2. If the rectangle below represents the @boardname@, shade the area that shows the value of the variable count. ```blocks let count = 0 @@ -18,7 +18,7 @@ let count = 0 ![](/static/mb/lessons/speed-button-0.png) -## 3. If the rectangle below represents the BBC micro:bit, shade the areas that will be displayed after two button presses on Button A. Explain why that particular area is shaded. +## 3. If the rectangle below represents the @boardname@, shade the areas that will be displayed after two button presses on Button A. Explain why that particular area is shaded. ```blocks let count = 0 @@ -34,7 +34,7 @@ input.onButtonPressed(Button.A, () => { After two button presses, **count** will be equal to 2. -## 5. If the rectangle below represents the BBC micro:bit, shade the areas that will be displayed after five button presses on Button A. Explain why that particular area is shaded. +## 5. If the rectangle below represents the @boardname@, shade the areas that will be displayed after five button presses on Button A. Explain why that particular area is shaded. ```blocks let count = 0 diff --git a/docs/lessons/spinner.md b/docs/lessons/spinner.md index 857a0f6c..71cd8399 100644 --- a/docs/lessons/spinner.md +++ b/docs/lessons/spinner.md @@ -1,6 +1,6 @@ # spinner lesson -a spin the BBC micro:bit game with the input on shake. +a spin the @boardname@ game with the input on shake. @@ -37,7 +37,7 @@ basic.showLeds(` ## Objectives -* learn how to run code when the BBC micro:bit is shaken, when running code in the web browser, moving the mouse quickly simulates shaking +* learn how to run code when the @boardname@ is shaken, when running code in the web browser, moving the mouse quickly simulates shaking * learn how to create a local variable as a place where you can store and retrieve data * learn how the assignment operator is used to declare a new local variable * learn how to declare a new local variable or update the value of a variable diff --git a/docs/lessons/spinner/quiz-answers.md b/docs/lessons/spinner/quiz-answers.md index 86b1ecd4..86865ebf 100644 --- a/docs/lessons/spinner/quiz-answers.md +++ b/docs/lessons/spinner/quiz-answers.md @@ -1,6 +1,6 @@ # spinner quiz answers -a spin the BBC micro:bit game with the input on shake. +a spin the @boardname@ game with the input on shake. ## Name diff --git a/docs/lessons/spinner/quiz.md b/docs/lessons/spinner/quiz.md index ad9c1d4a..f815f11c 100644 --- a/docs/lessons/spinner/quiz.md +++ b/docs/lessons/spinner/quiz.md @@ -1,6 +1,6 @@ # spinner quiz -a spin the BBC micro:bit game with the input on shake. +a spin the @boardname@ game with the input on shake. ## Name diff --git a/docs/lessons/stem.md b/docs/lessons/stem.md index 7d79dbcd..d4b02efc 100644 --- a/docs/lessons/stem.md +++ b/docs/lessons/stem.md @@ -1,6 +1,6 @@ # Block Editor STEM Lessons -Overview of Blocks lessons for the BBC micro:bit. +Overview of Blocks lessons for the @boardname@. ### @short Lessons @@ -9,9 +9,9 @@ Overview of Blocks lessons for the BBC micro:bit. ## Science * [Night Light](/lessons/night-light), dim the LEDs with set brightness -* [Hack your headphones](/projects/hack-your-headphones), create music on the BBC micro:bit by hacking your headphones +* [Hack your headphones](/projects/hack-your-headphones), create music on the @boardname@ by hacking your headphones * [Banana Keyboard](/projects/banana-keyboard), create music with fruits -* [Telegraph](/projects/telegraph), play the telegraph game between 2 BBC micro:bits +* [Telegraph](/projects/telegraph), play the telegraph game between 2 @boardname@s * [Zoomer](/lessons/zoomer), measure the force with acceleration * [Glowing pendulum](/lessons/glowing-pendulum), construct a pendulum that glows using acceleration @@ -30,7 +30,7 @@ Overview of Blocks lessons for the BBC micro:bit. * [Flashing heart](/lessons/flashing-heart), display images with a pause * [Blink](/lessons/blink), turn an LED on and off with plot * [Happy birthday](/lessons/happy-birthday), create a popular song -* [Magic 8](/lessons/magic-8), a fortune teller game with the BBC micro:bit +* [Magic 8](/lessons/magic-8), a fortune teller game with the @boardname@ ### ~ diff --git a/docs/lessons/teach.md b/docs/lessons/teach.md index 6b9d24ba..016d1e1d 100644 --- a/docs/lessons/teach.md +++ b/docs/lessons/teach.md @@ -1,6 +1,6 @@ # Teach Blocks -Overview of lesson instructions for the BBC micro:bit. +Overview of lesson instructions for the @boardname@. ### @short Teach @@ -34,7 +34,7 @@ The quiz answers provide responses to the quiz. This will allow teachers to accu 5) Challenges -After the student completes the quiz, tutorial, and compiles the code onto the BBC micro:bit, distribute the lesson’s challenges. Challenges are additional customizing and exercises for the students. Challenges reinforce the concepts followed in the tutorial and quiz responses as shown with the [blink challenges](/lessons/blink/challenges). +After the student completes the quiz, tutorial, and compiles the code onto the @boardname@, distribute the lesson’s challenges. Challenges are additional customizing and exercises for the students. Challenges reinforce the concepts followed in the tutorial and quiz responses as shown with the [blink challenges](/lessons/blink/challenges). ## Teacher Directions @@ -48,7 +48,7 @@ After the student completes the quiz, tutorial, and compiles the code onto the B 5) Complete quiz questions by following the the guided tutorials -6) Compile the code from the tutorial onto the BBC micro:bit +6) Compile the code from the tutorial onto the @boardname@ 7) Distribute the challenges for additional coding through paper instructions @@ -66,7 +66,7 @@ After the student completes the quiz, tutorial, and compiles the code onto the B ``05:00`` Distribute Lesson Quiz -``07:00`` Access BBC micro:bit website +``07:00`` Access @boardname@ website ``10:00`` Start Lesson Activity & Lesson Quiz diff --git a/docs/lessons/temperature.md b/docs/lessons/temperature.md index 219a101a..a2442fbb 100644 --- a/docs/lessons/temperature.md +++ b/docs/lessons/temperature.md @@ -1,6 +1,6 @@ # temperature blocks lesson -measure the temperature on the BBC micro:bit. +measure the temperature on the @boardname@. ## Topic diff --git a/docs/lessons/truth-or-dare.md b/docs/lessons/truth-or-dare.md index 25899676..8d1d1f33 100644 --- a/docs/lessons/truth-or-dare.md +++ b/docs/lessons/truth-or-dare.md @@ -1,6 +1,6 @@ # truth or dare lesson -create a love meter with the BBC micro:bit. +create a love meter with the @boardname@. @@ -39,7 +39,7 @@ basic.showString("Hello!") ## Objectives -* learn how to display an image on the BBC micro:bit +* learn how to display an image on the @boardname@ * learn how to run code when an input button is pressed * learn how to a create a variable for a place where you can store and retrieve data * learn how to declare a new local variable or update the value of a variable diff --git a/docs/lessons/truth-or-dare/activity.md b/docs/lessons/truth-or-dare/activity.md index fba91d63..0d15c81a 100644 --- a/docs/lessons/truth-or-dare/activity.md +++ b/docs/lessons/truth-or-dare/activity.md @@ -23,7 +23,7 @@ basic.showLeds(` ``` -Now let's create a condition to know when button `A` is pressed so that we can display "truth" or "dare" on the micro:bit. We want the BBC micro:bit to randomly choose whether to display "truth" or display "dare". We can use accomplish this by using `pick random (1)`. +Now let's create a condition to know when button `A` is pressed so that we can display "truth" or "dare" on the micro:bit. We want the @boardname@ to randomly choose whether to display "truth" or display "dare". We can use accomplish this by using `pick random (1)`. ```blocks basic.showLeds(` diff --git a/docs/lessons/truth-or-dare/quiz-answers.md b/docs/lessons/truth-or-dare/quiz-answers.md index 11ac8f1d..a9fb533c 100644 --- a/docs/lessons/truth-or-dare/quiz-answers.md +++ b/docs/lessons/truth-or-dare/quiz-answers.md @@ -10,7 +10,7 @@ This is the answer key for the [truth or dare quiz](/lessons/truth-or-dare/quiz) let random = Math.random(4) ``` -## 2. Write an if statement that will display the message "TRUTH" on the BBC micro:bit if the local variable 'random' equals 0. +## 2. Write an if statement that will display the message "TRUTH" on the @boardname@ if the local variable 'random' equals 0. ```blocks let random = Math.random(4) diff --git a/docs/lessons/truth-or-dare/quiz.md b/docs/lessons/truth-or-dare/quiz.md index e3c6e4be..40efade5 100644 --- a/docs/lessons/truth-or-dare/quiz.md +++ b/docs/lessons/truth-or-dare/quiz.md @@ -16,7 +16,7 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
-## 2. Write an if statement that will display the message "TRUTH" on the BBC micro:bit if the local variable 'random' equals 0. +## 2. Write an if statement that will display the message "TRUTH" on the @boardname@ if the local variable 'random' equals 0.
diff --git a/docs/lessons/truth-or-dare/tutorial.md b/docs/lessons/truth-or-dare/tutorial.md index d58ea784..f35ddf74 100644 --- a/docs/lessons/truth-or-dare/tutorial.md +++ b/docs/lessons/truth-or-dare/tutorial.md @@ -4,7 +4,7 @@ -The *Truth or dare!* game works as follows: a player spins the BBC micro:bit on the table. +The *Truth or dare!* game works as follows: a player spins the @boardname@ on the table. When the micro:bit stops spinning, the player pointed by the arrow (displayed on screen) must press the button "A" to see if she has to provide a *truth* or a *dare*. diff --git a/docs/lessons/variables.md b/docs/lessons/variables.md index 8b6dd215..ebfe16be 100644 --- a/docs/lessons/variables.md +++ b/docs/lessons/variables.md @@ -4,7 +4,7 @@ An introduction to variables for the Block Editor. ## What is a variable? -Variables are things that are remembered by the BBC micro:bit. Variables can take a few formats and can have functions applied to them. For example, we could create a string, which is text. Or we could create a calculator that stores whichever number the user inputs as an integer, or whole number. +Variables are things that are remembered by the @boardname@. Variables can take a few formats and can have functions applied to them. For example, we could create a string, which is text. Or we could create a calculator that stores whichever number the user inputs as an integer, or whole number. We can modify variables but they must first be defined. Open the ‘Variables’ drawer to the left of your code. @@ -31,7 +31,7 @@ Finally, beneath that line, drag a `show number` block from the **Basic** drawer * We create a new variable called value and set it to 0 * The code runs forever and waits for the user to press the A button * When the user does, value will be set to value + 1 (value will be incremented by 1) -* Value will then be displayed on the BBC micro:bit's LEDS +* Value will then be displayed on the @boardname@'s LEDS * This effectively creates a counter Variables can also be used for conditions with loops. See the 'Loops' section to learn about this. diff --git a/docs/lessons/zoomer/quiz-answers.md b/docs/lessons/zoomer/quiz-answers.md index 3144e594..a58e7078 100644 --- a/docs/lessons/zoomer/quiz-answers.md +++ b/docs/lessons/zoomer/quiz-answers.md @@ -6,7 +6,7 @@ This is the answer key for the [zoomer quiz](/lessons/zoomer/quiz). ## 1. What is 'acceleration'? -Acceleration is amount of force being applied to the BBC micro:bit in one of three specified directions. +Acceleration is amount of force being applied to the @boardname@ in one of three specified directions. ## 2. Consider the following directions @@ -22,7 +22,7 @@ Note: acceleration does not have be measured in the "x" direction. It can also b ## 3. Consider the following directions -After storing the acceleration in a variable, write the code to show acceleration on the BBC micro:bit as a number +After storing the acceleration in a variable, write the code to show acceleration on the @boardname@ as a number
diff --git a/docs/lessons/zoomer/quiz.md b/docs/lessons/zoomer/quiz.md index 822c2de3..e9524f01 100644 --- a/docs/lessons/zoomer/quiz.md +++ b/docs/lessons/zoomer/quiz.md @@ -18,7 +18,7 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
-## 3. After storing the acceleration in a variable, write the code to show acceleration on the BBC micro:bit as a number. +## 3. After storing the acceleration in a variable, write the code to show acceleration on the @boardname@ as a number.
diff --git a/docs/projects/rock-paper-scissors.md b/docs/projects/rock-paper-scissors.md index 5a9b1639..b3bcfc0b 100644 --- a/docs/projects/rock-paper-scissors.md +++ b/docs/projects/rock-paper-scissors.md @@ -35,7 +35,7 @@ input.onGesture(Gesture.Shake, () => { } }) ``` -In this project, you will build a Rock Paper Scissors game with the BBC micro:bit. +In this project, you will build a Rock Paper Scissors game with the @boardname@. 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. @@ -44,7 +44,7 @@ You can also play it with friends who are just using their hands. ## Materials needed -* Your BBC micro:bit -- that's it! +* Your @boardname@ -- that's it! ## Step 1: Getting started diff --git a/docs/reference/basic/forever.md b/docs/reference/basic/forever.md index b961e426..3569eb7d 100644 --- a/docs/reference/basic/forever.md +++ b/docs/reference/basic/forever.md @@ -35,7 +35,7 @@ basic.forever(() => { The following example keeps showing the [number](/reference/types/number) stored in a global variable. When you press button `A`, the number gets bigger. -You can use a program like this to count things with your BBC micro:bit. +You can use a program like this to count things with your @boardname@. ```blocks let num = 0 diff --git a/docs/reference/basic/show-animation.md b/docs/reference/basic/show-animation.md index f8daaf46..3259b049 100644 --- a/docs/reference/basic/show-animation.md +++ b/docs/reference/basic/show-animation.md @@ -21,7 +21,7 @@ basic.showAnimation(` In this animation, each row is 15 spaces wide because there are three frames in the animation, and each frame is -five spaces wide, just like the screen on the BBC micro:bit. +five spaces wide, just like the screen on the @boardname@. ```blocks basic.showAnimation(` diff --git a/docs/reference/bluetooth/about-bluetooth.md b/docs/reference/bluetooth/about-bluetooth.md index c695f164..63d1a8cc 100755 --- a/docs/reference/bluetooth/about-bluetooth.md +++ b/docs/reference/bluetooth/about-bluetooth.md @@ -66,9 +66,9 @@ Everything described above relates to devices which are connected and communicat In GAP, one devices advertises, emitting small packets of data periodically. These packets contain information about the device doing the advertising. Other devices looking for devices to connect to perform something called scanning, receiving and processing advertising packets and filtering out those that come from devices of a type that are not of interest. Usually the user is given information about devices which are discovered and they then select one to be connected to. The device which advertises is called a Bluetooth Peripheral whereas the one doing the scanning is a Bluetooth Central device. micro:bit is a Bluetooth peripheral. -Bluetooth on the BBC micro:bit +Bluetooth on the @boardname@ -Full documentation for the BBC micro:bit Bluetooth profile as used by this application can be found at the [Lancaster University documentation](http://lancaster-university.github.io/microbit-docs/ble/profile/) web site. +Full documentation for the @boardname@ Bluetooth profile as used by this application can be found at the [Lancaster University documentation](http://lancaster-university.github.io/microbit-docs/ble/profile/) web site. The micro:bit's accelerometer (motion detector), magnetometer (digital compass), two buttons on the front, LED Display, IO pins on the edge connector, internal message bus and internal temperature sensor are all exposed as Services so that applications can exploit these features of the device. In addition: @@ -82,7 +82,7 @@ Everything you can do with the micro:bit over Bluetooth is achieved through read The Bluetooth SIG web site at http://www.bluetooth.com is a good place for further information about Bluetooth in general. You'll find all the SIG defined profiles, services, characteristics and descriptors there as well as the core specification for all Bluetooth technology. -That's it! Enjoy using Bluetooth on the BBC micro:bit! +That's it! Enjoy using Bluetooth on the @boardname@! Martin Woolley, Bluetooth SIG. Twitter: @bluetooth_mdw diff --git a/docs/reference/bluetooth/bluetooth-pairing.md b/docs/reference/bluetooth/bluetooth-pairing.md index 8e5247cf..21164a2a 100755 --- a/docs/reference/bluetooth/bluetooth-pairing.md +++ b/docs/reference/bluetooth/bluetooth-pairing.md @@ -31,7 +31,7 @@ Your micro:bit is now ready to be paired with the other device. Read the section 1. Go into Settings 2. Select Bluetooth 3. Switch your micro:bit into 'pairing mode' using the steps above -4. Wait until 'PAIRING MODE!' has finished scrolling across the micro:bit display. You should see your micro:bit listed on your Windows smartphone with a name something like 'BBC micro:bit [zatig]'. Note that the 5 characters in brackets at the end will vary. +4. Wait until 'PAIRING MODE!' has finished scrolling across the micro:bit display. You should see your micro:bit listed on your Windows smartphone with a name something like '@boardname@ [zatig]'. Note that the 5 characters in brackets at the end will vary. 5. On the Windows smartphone, tap the micro:bit named in the device list. This will initiate the pairing process. 6. The micro:bit will display a left pointing arrow and the Windows smartphone will pop up a box into which you will be invited to enter a "pin" (Personal Identity Number). 7. Press button A on the micro:bit and watch carefully as the micro:bit displays a sequence of 6 random numbers. You may find it easier to write them down than to remember them. @@ -47,7 +47,7 @@ https://www.youtube.com/watch?v=AoW3mit7jIg 1. Go into Settings 2. Select Bluetooth 3. Switch your micro:bit into 'pairing mode' using the steps above -4. Wait until 'PAIRING MODE!' has finished scrolling across the micro:bit display. You should see your micro:bit listed on your Android smartphone under the heading "Available devices" with a name something like 'BBC micro:bit [zatig]'. Note that the 5 characters in brackets at the end will vary. +4. Wait until 'PAIRING MODE!' has finished scrolling across the micro:bit display. You should see your micro:bit listed on your Android smartphone under the heading "Available devices" with a name something like '@boardname@ [zatig]'. Note that the 5 characters in brackets at the end will vary. 5. On the Android smartphone, tap the micro:bit named in the Available devices list. This will initiate the pairing process. 6. The micro:bit will display a left pointing arrow and the Android smartphone will pop up a box into which you will be invited to enter a "pin" (Personal Identity Number). 7. Press button A on the micro:bit and watch carefully as the micro:bit displays a sequence of 6 random numbers. You may find it easier to write them down than to remember them. diff --git a/docs/reference/control/reset.md b/docs/reference/control/reset.md index 59ba8cbe..706d3cfd 100644 --- a/docs/reference/control/reset.md +++ b/docs/reference/control/reset.md @@ -1,6 +1,6 @@ # Reset -Reset the BBC micro:bit and start the program again. +Reset the @boardname@ and start the program again. This function is like pressing the reset button on the back of the micro:bit. diff --git a/docs/reference/devices.md b/docs/reference/devices.md index 01d8be15..e94704b3 100644 --- a/docs/reference/devices.md +++ b/docs/reference/devices.md @@ -1,6 +1,6 @@ # Devices -Control a phone with the BBC micro:bit via Bluetooth. +Control a phone with the @boardname@ via Bluetooth. ```cards devices.tellCameraTo(MesCameraEvent.TakePhoto); diff --git a/docs/reference/devices/on-gamepad-button.md b/docs/reference/devices/on-gamepad-button.md index baba8246..3754d942 100644 --- a/docs/reference/devices/on-gamepad-button.md +++ b/docs/reference/devices/on-gamepad-button.md @@ -4,9 +4,9 @@ Register code to run when the micro:bit receives a command from the paired gamep ### ~hint -The functions in the ``devices`` namespace allow the BBC micro:bit to communicate with a separate (remote) device, +The functions in the ``devices`` namespace allow the @boardname@ to communicate with a separate (remote) device, such as a smartphone, over Bluetooth (Smart). -The set of supported events will depend on the remote device and the BBC micro:bit apps available for the remote device. +The set of supported events will depend on the remote device and the @boardname@ apps available for the remote device. ### ~ diff --git a/docs/reference/devices/on-notified.md b/docs/reference/devices/on-notified.md index 693e0b41..456d88af 100644 --- a/docs/reference/devices/on-notified.md +++ b/docs/reference/devices/on-notified.md @@ -4,9 +4,9 @@ Register code to run when the signal strength of the paired device changes. ### ~hint -The functions in the ``devices`` namespace allow the BBC micro:bit to communicate with a separate (remote) device, +The functions in the ``devices`` namespace allow the @boardname@ to communicate with a separate (remote) device, such as a smartphone, over Bluetooth (Smart). -The set of supported events will depend on the remote device and the BBC micro:bit apps available for the remote device. +The set of supported events will depend on the remote device and the @boardname@ apps available for the remote device. ### ~ diff --git a/docs/reference/devices/on-signal-strength-changed.md b/docs/reference/devices/on-signal-strength-changed.md index f0894c50..b51b3345 100644 --- a/docs/reference/devices/on-signal-strength-changed.md +++ b/docs/reference/devices/on-signal-strength-changed.md @@ -4,9 +4,9 @@ Register code to run when the signal strength of the paired device changes. ### ~hint -The functions in the ``devices`` namespace allow the BBC micro:bit to communicate with a separate (remote) device, +The functions in the ``devices`` namespace allow the @boardname@ to communicate with a separate (remote) device, such as a smartphone, over Bluetooth (Smart). -The set of supported events will depend on the remote device and the BBC micro:bit apps available for the remote device. +The set of supported events will depend on the remote device and the @boardname@ apps available for the remote device. ### ~ diff --git a/docs/reference/devices/raise-alert-to.md b/docs/reference/devices/raise-alert-to.md index a226ac1f..a0fabbab 100644 --- a/docs/reference/devices/raise-alert-to.md +++ b/docs/reference/devices/raise-alert-to.md @@ -4,9 +4,9 @@ Raise an alert on a remote device. ### ~hint -The functions in the ``devices`` namespace allow the BBC micro:bit to communicate with a separate (remote) device, +The functions in the ``devices`` namespace allow the @boardname@ to communicate with a separate (remote) device, such as a smartphone, over Bluetooth (Smart). -The set of supported events will depend on the remote device and the BBC micro:bit apps available for the remote device. +The set of supported events will depend on the remote device and the @boardname@ apps available for the remote device. ### ~ diff --git a/docs/reference/devices/signal-strength.md b/docs/reference/devices/signal-strength.md index a60a710d..7df8b9f4 100644 --- a/docs/reference/devices/signal-strength.md +++ b/docs/reference/devices/signal-strength.md @@ -4,9 +4,9 @@ Returns the signal strength reported by the paired device from ``0`` (no signal) ### ~hint -The functions in the ``devices`` namespace allow the BBC micro:bit to communicate with a separate (remote) device, +The functions in the ``devices`` namespace allow the @boardname@ to communicate with a separate (remote) device, such as a smartphone, over Bluetooth (Smart). -The set of supported events will depend on the remote device and the BBC micro:bit apps available for the remote device. +The set of supported events will depend on the remote device and the @boardname@ apps available for the remote device. ### ~ diff --git a/docs/reference/devices/tell-camera-to.md b/docs/reference/devices/tell-camera-to.md index 81edb728..70b9ac7c 100644 --- a/docs/reference/devices/tell-camera-to.md +++ b/docs/reference/devices/tell-camera-to.md @@ -4,9 +4,9 @@ Access the photo/video-taking functionality of a remote device using the ``tell ### ~hint -The functions in the ``devices`` namespace allow the BBC micro:bit to communicate with a separate (remote) device, +The functions in the ``devices`` namespace allow the @boardname@ to communicate with a separate (remote) device, such as a smartphone, over Bluetooth (Smart). -The set of supported events will depend on the remote device and the BBC micro:bit apps available for the remote device. +The set of supported events will depend on the remote device and the @boardname@ apps available for the remote device. ### ~ diff --git a/docs/reference/devices/tell-remote-control-to.md b/docs/reference/devices/tell-remote-control-to.md index fa141892..266a983e 100644 --- a/docs/reference/devices/tell-remote-control-to.md +++ b/docs/reference/devices/tell-remote-control-to.md @@ -4,9 +4,9 @@ Control the presentation of media content available on a remote device using the ### ~hint -The functions in the ``devices`` namespace allow the BBC micro:bit to communicate with a separate (remote) device, +The functions in the ``devices`` namespace allow the @boardname@ to communicate with a separate (remote) device, such as a smartphone, over Bluetooth (Smart). -The set of supported events will depend on the remote device and the BBC micro:bit apps available for the remote device. +The set of supported events will depend on the remote device and the @boardname@ apps available for the remote device. ### ~ diff --git a/docs/reference/event-handler.md b/docs/reference/event-handler.md index 73a249e8..03605161 100644 --- a/docs/reference/event-handler.md +++ b/docs/reference/event-handler.md @@ -51,7 +51,7 @@ input.onButtonPressed(Button.A, () => { ### To learn more -To learn more about how the BBC micro:bit queues up and schedules event handlers, see [the BBC micro:bit - a reactive system](/device/reactive) +To learn more about how the @boardname@ queues up and schedules event handlers, see [the @boardname@ - a reactive system](/device/reactive) ### see also diff --git a/docs/reference/images/plot-frame.md b/docs/reference/images/plot-frame.md index c4a2f580..b49ed1de 100644 --- a/docs/reference/images/plot-frame.md +++ b/docs/reference/images/plot-frame.md @@ -2,7 +2,7 @@ The plot frame function. -Display an [Image](/reference/images/image) on the BBC micro:bit's [LED screen](/device/screen) +Display an [Image](/reference/images/image) on the @boardname@'s [LED screen](/device/screen) ### JavaScript diff --git a/docs/reference/images/plot-image.md b/docs/reference/images/plot-image.md index bddd000e..b51daa76 100644 --- a/docs/reference/images/plot-image.md +++ b/docs/reference/images/plot-image.md @@ -2,7 +2,7 @@ The plot image function. -Display an [Image](/reference/images/image) on the BBC micro:bit's [LED screen](/device/screen) +Display an [Image](/reference/images/image) on the @boardname@'s [LED screen](/device/screen) ### JavaScript diff --git a/docs/reference/images/show-frame.md b/docs/reference/images/show-frame.md index 0c2b11bc..18134bb4 100644 --- a/docs/reference/images/show-frame.md +++ b/docs/reference/images/show-frame.md @@ -2,7 +2,7 @@ The show frame function. -Display an [Image](/reference/images/image) on the BBC micro:bit's [LED screen](/device/screen) +Display an [Image](/reference/images/image) on the @boardname@'s [LED screen](/device/screen) ### JavaScript diff --git a/docs/reference/input/light-level.md b/docs/reference/input/light-level.md index e67cdf34..b9270b0c 100644 --- a/docs/reference/input/light-level.md +++ b/docs/reference/input/light-level.md @@ -2,7 +2,7 @@ Find the light level (how bright or dark it is) where you are. The light level ``0`` means darkness and ``255`` means bright light. -The BBC micro:bit measures the light around it by using some of the +The @boardname@ measures the light around it by using some of the LEDs on the [LED screen](/device/screen). The first time you use it, this function will say ``0``. diff --git a/docs/reference/input/on-button-pressed.md b/docs/reference/input/on-button-pressed.md index 0d2608c9..ede3f410 100644 --- a/docs/reference/input/on-button-pressed.md +++ b/docs/reference/input/on-button-pressed.md @@ -3,7 +3,7 @@ Start an [event handler](/reference/event-handler) (part of the program that will run when something happens, like when a button is pressed). This handler works when button `A` or `B` is pressed, or `A` and `B` together. When you are using this function in a web browser, click the buttons on the screen instead of the ones -on the BBC micro:bit. +on the @boardname@. ```sig input.onButtonPressed(Button.A, () => {}) diff --git a/docs/reference/input/on-pin-pressed.md b/docs/reference/input/on-pin-pressed.md index f37c3126..f1b53bd7 100644 --- a/docs/reference/input/on-pin-pressed.md +++ b/docs/reference/input/on-pin-pressed.md @@ -19,7 +19,7 @@ input.onPinPressed(TouchPin.P0, () => { ## ~hint -This function works best when the BBC micro:bit is using batteries for power, +This function works best when the @boardname@ is using batteries for power, instead of the USB cable. ## ~ @@ -44,5 +44,5 @@ input.onPinPressed(TouchPin.P0, () => { ### See also -[BBC micro:bit pins](/device/pins), [pin is pressed](/reference/input/pin-is-pressed), [analog read pin](/reference/pins/analog-read-pin), [analog write pin](/reference/pins/analog-write-pin), [digital read pin](/reference/pins/digital-read-pin), [digital write pin](/reference/pins/digital-write-pin) +[@boardname@ pins](/device/pins), [pin is pressed](/reference/input/pin-is-pressed), [analog read pin](/reference/pins/analog-read-pin), [analog write pin](/reference/pins/analog-write-pin), [digital read pin](/reference/pins/digital-read-pin), [digital write pin](/reference/pins/digital-write-pin) diff --git a/docs/reference/input/on-pin-released.md b/docs/reference/input/on-pin-released.md index 49f7dabc..e06610c4 100644 --- a/docs/reference/input/on-pin-released.md +++ b/docs/reference/input/on-pin-released.md @@ -19,7 +19,7 @@ input.onPinReleased(TouchPin.P0, () => { ## ~hint -This function works best when the BBC micro:bit is using batteries for power, +This function works best when the @boardname@ is using batteries for power, instead of the USB cable. ## ~ @@ -44,5 +44,5 @@ input.onPinReleased(TouchPin.P0, () => { ### See also -[BBC micro:bit pins](/device/pins), [pin is pressed](/reference/input/pin-is-pressed), [analog read pin](/reference/pins/analog-read-pin), [analog write pin](/reference/pins/analog-write-pin), [digital read pin](/reference/pins/digital-read-pin), [digital write pin](/reference/pins/digital-write-pin) +[@boardname@ pins](/device/pins), [pin is pressed](/reference/input/pin-is-pressed), [analog read pin](/reference/pins/analog-read-pin), [analog write pin](/reference/pins/analog-write-pin), [digital read pin](/reference/pins/digital-read-pin), [digital write pin](/reference/pins/digital-write-pin) diff --git a/docs/reference/input/pin-is-pressed.md b/docs/reference/input/pin-is-pressed.md index 14d3db6f..b659c9a5 100644 --- a/docs/reference/input/pin-is-pressed.md +++ b/docs/reference/input/pin-is-pressed.md @@ -12,7 +12,7 @@ input.pinIsPressed(TouchPin.P0); ## ~hint -This function works best when the BBC micro:bit is using batteries for power, +This function works best when the @boardname@ is using batteries for power, instead of the USB cable. ## ~ @@ -41,5 +41,5 @@ basic.forever(() => { ### See also -[BBC micro:bit pins](/device/pins), [on pin pressed](/reference/input/on-pin-pressed), [analog read pin](/reference/pins/analog-read-pin), [analog write pin](/reference/pins/analog-write-pin), [digital read pin](/reference/pins/digital-read-pin), [digital write pin](/reference/pins/digital-write-pin) +[@boardname@ pins](/device/pins), [on pin pressed](/reference/input/on-pin-pressed), [analog read pin](/reference/pins/analog-read-pin), [analog write pin](/reference/pins/analog-write-pin), [digital read pin](/reference/pins/digital-read-pin), [digital write pin](/reference/pins/digital-write-pin) diff --git a/docs/reference/input/rotation.md b/docs/reference/input/rotation.md index 4b4f8429..2d98efbd 100644 --- a/docs/reference/input/rotation.md +++ b/docs/reference/input/rotation.md @@ -8,7 +8,7 @@ input.rotation(Rotation.Roll); ## ~hint -The BBC micro:bit has a part called the **accelerometer** that can +The @boardname@ has a part called the **accelerometer** that can check how the micro:bit is moving. ## ~ @@ -23,7 +23,7 @@ check how the micro:bit is moving. ### Example: micro:bit leveler -This program helps you move the BBC micro:bit until it is level. When +This program helps you move the @boardname@ until it is level. When it is level, the micro:bit shows a smiley. If you are running this program in a browser, you can tilt the diff --git a/docs/reference/input/temperature.md b/docs/reference/input/temperature.md index f0b234bf..d83ca741 100644 --- a/docs/reference/input/temperature.md +++ b/docs/reference/input/temperature.md @@ -13,7 +13,7 @@ input.temperature(); ### How does it work? -The BBC micro:bit checks how hot its CPU (main computer chip) is. +The @boardname@ checks how hot its CPU (main computer chip) is. Because the micro:bit does not usually get very hot, the temperature of the CPU is usually close to the temperature of wherever you are. The micro:bit might warm up a little if you make it work hard, though! diff --git a/docs/reference/led/plot-bar-graph.md b/docs/reference/led/plot-bar-graph.md index f2550ee2..851f2fc8 100644 --- a/docs/reference/led/plot-bar-graph.md +++ b/docs/reference/led/plot-bar-graph.md @@ -11,7 +11,7 @@ led.plotBarGraph(2, 20); * ``value`` is a [number](/reference/types/number) that means what you are measuring or trying to show. For example, if you are measuring - the temperature of ice with the BBC micro:bit, ``value`` might be `0` + the temperature of ice with the @boardname@, ``value`` might be `0` because the temperature might be 0 degrees centigrade. * ``high`` is a [number](/reference/types/number) that means the highest possible number that the ``value`` parameter can be. This number is diff --git a/docs/reference/led/plot-leds.md b/docs/reference/led/plot-leds.md index dd796a45..3c920c9d 100644 --- a/docs/reference/led/plot-leds.md +++ b/docs/reference/led/plot-leds.md @@ -1,6 +1,6 @@ # Plot LEDs -Display an [Image](/reference/images/image) on the BBC micro:bit's [LED screen](/device/screen). NOTE: `basic -> plot image` has been replaced by `basic -> show leds`. +Display an [Image](/reference/images/image) on the @boardname@'s [LED screen](/device/screen). NOTE: `basic -> plot image` has been replaced by `basic -> show leds`. ```sig basic.showLeds(` diff --git a/docs/reference/out-of-bounds.md b/docs/reference/out-of-bounds.md index a052a4e3..7bbc627d 100644 --- a/docs/reference/out-of-bounds.md +++ b/docs/reference/out-of-bounds.md @@ -2,7 +2,7 @@ The behavior of functions whose parameter values are out of bounds. -Many of the BBC micro:bit functions have parameters. If a parameter is an unexpected value, the parameter is considered *out of bounds*. +Many of the @boardname@ functions have parameters. If a parameter is an unexpected value, the parameter is considered *out of bounds*. For example, the [plot](/reference/led/plot) function has two parameters: diff --git a/docs/reference/pins/servo-set-pulse.md b/docs/reference/pins/servo-set-pulse.md index 65c1c81f..0bf38e10 100644 --- a/docs/reference/pins/servo-set-pulse.md +++ b/docs/reference/pins/servo-set-pulse.md @@ -22,7 +22,7 @@ pins.servoSetPulse(AnalogPin.P0, 1000) ### See also -[BBC micro:bit pins](/device/pins), +[@boardname@ pins](/device/pins), [on pin pressed](/reference/input/on-pin-pressed), [analog read pin](/reference/pins/analog-read-pin), [digital read pin](/reference/pins/digital-read-pin), diff --git a/docs/reference/pins/servo-write-pin.md b/docs/reference/pins/servo-write-pin.md index 8e093bc1..db2ccb41 100644 --- a/docs/reference/pins/servo-write-pin.md +++ b/docs/reference/pins/servo-write-pin.md @@ -44,5 +44,5 @@ pins.servoWritePin(AnalogPin.P0, 0) ### See also -[BBC micro:bit pins](/device/pins), [servo set pulse](/reference/pins/servo-set-pulse) +[@boardname@ pins](/device/pins), [servo set pulse](/reference/pins/servo-set-pulse) diff --git a/docs/reference/pins/set-pull.md b/docs/reference/pins/set-pull.md index 6d056455..2b62c5e3 100644 --- a/docs/reference/pins/set-pull.md +++ b/docs/reference/pins/set-pull.md @@ -29,4 +29,4 @@ pins.setPull(DigitalPin.P0, PinPullMode.PullUp); ### See also -[BBC micro:bit | mbed](https://developer.mbed.org/platforms/Microbit/) +[@boardname@ | mbed](https://developer.mbed.org/platforms/Microbit/) diff --git a/docs/reference/types.md b/docs/reference/types.md index e248ab76..44f83fc8 100644 --- a/docs/reference/types.md +++ b/docs/reference/types.md @@ -1,7 +1,7 @@ # types A *type* refers to a class of data and the operations permitted on that class of data. -The following built-in types are supported for the BBC micro:bit: +The following built-in types are supported for the @boardname@: * **[String](/reference/types/string)**: a sequence of characters * **[Number](/reference/types/number)**: an integer number (32-bit signed) diff --git a/docs/reference/types/string.md b/docs/reference/types/string.md index cb821a96..f2204d3c 100644 --- a/docs/reference/types/string.md +++ b/docs/reference/types/string.md @@ -4,7 +4,7 @@ a piece of text. ### @parent blocks/language -A *String* is a sequence of characters. For the BBC micro:bit, ASCII character codes 32 to 126 are supported; letters, digits, punctuation marks, and a few symbols. All other character codes appear as a ? on the [LED screen](/device/screen). +A *String* is a sequence of characters. For the @boardname@, ASCII character codes 32 to 126 are supported; letters, digits, punctuation marks, and a few symbols. All other character codes appear as a ? on the [LED screen](/device/screen). ### Create a string variable diff --git a/olddocs/js/compiler.md b/olddocs/js/compiler.md index 8bba5b54..88c0e519 100644 --- a/olddocs/js/compiler.md +++ b/olddocs/js/compiler.md @@ -1,6 +1,6 @@ # In-browser compiler -The BBC micro:bit pins. +The @boardname@ pins. ## We listened to your feedback! @@ -12,7 +12,7 @@ Following the feedback from teachers, the following improvements were made: ## A new in-browser compiler -The compilation from a script to ARM machine code is now done entirely in the browser (read the [in depth story](https://www.touchdevelop.com/docs/touch-develop-in-208-bits) about building the compiler). The new compiler is used by the Block Editor, Touch Develop and Code Kingdoms to create a .hex file solely within the confines of your web browser (no Internet connection is needed). The BBC micro:bit compilation process (see page 10 in the Quick Start book) has been updated below to reflect the new compiler architecture, shown below. +The compilation from a script to ARM machine code is now done entirely in the browser (read the [in depth story](https://www.touchdevelop.com/docs/touch-develop-in-208-bits) about building the compiler). The new compiler is used by the Block Editor, Touch Develop and Code Kingdoms to create a .hex file solely within the confines of your web browser (no Internet connection is needed). The @boardname@ compilation process (see page 10 in the Quick Start book) has been updated below to reflect the new compiler architecture, shown below. ![](/static/mb/offline-2.png) @@ -22,7 +22,7 @@ The C++ compiler now only is used to compile the micro:bit runtime - this is don ![](/static/mb/offline-0.png) -The BBC micro:bit automatically saves and synchronizes scripts for signed in users through the cloud. Unfortunately, this scenario would not work always so we decided to also support files. Users are now able to import and export scripts as files. For example, they can simply email it or submit them in their classroom portal. +The @boardname@ automatically saves and synchronizes scripts for signed in users through the cloud. Unfortunately, this scenario would not work always so we decided to also support files. Users are now able to import and export scripts as files. For example, they can simply email it or submit them in their classroom portal. ![](/static/mb/offline-1.png) diff --git a/olddocs/js/contents.md b/olddocs/js/contents.md index f332620f..e1137e08 100644 --- a/olddocs/js/contents.md +++ b/olddocs/js/contents.md @@ -14,10 +14,10 @@ JavaScript docs for the micro:bit ### ~ -Welcome to the Touch Develop home page for the BBC micro:bit. Below you will find resources about the Touch Develop programming language and code editor. Good places to start include: +Welcome to the Touch Develop home page for the @boardname@. Below you will find resources about the Touch Develop programming language and code editor. Good places to start include: * [the Touch Develop Editor](/js/editor) -* [30+ BBC micro:bit lessons](/lessonss) +* [30+ @boardname@ lessons](/lessonss) * [offline support](/offline) ### ~column @@ -92,7 +92,7 @@ Welcome to the Touch Develop home page for the BBC micro:bit. Below you will fin ### ~column -## BBC micro:bit functions +## @boardname@ functions ### Basic @@ -190,7 +190,7 @@ Functions in this category require to be connected to a remote device. ## Run * [scripts in the browser](/js/simulator) -* [scripts on your BBC micro:bit](/device/usb) +* [scripts on your @boardname@](/device/usb) ## Debugging diff --git a/olddocs/js/event-handler.md b/olddocs/js/event-handler.md index ab770716..842ee066 100644 --- a/olddocs/js/event-handler.md +++ b/olddocs/js/event-handler.md @@ -51,7 +51,7 @@ input.onButtonPressed(Button.A, () => { ### To learn more -To learn more about how the BBC micro:bit queues up and schedules event handlers, see [the BBC micro:bit - a reactive system](/device/reactive) +To learn more about how the @boardname@ queues up and schedules event handlers, see [the @boardname@ - a reactive system](/device/reactive) ### see also diff --git a/olddocs/js/events.md b/olddocs/js/events.md index bdabc82e..f24bb09d 100644 --- a/olddocs/js/events.md +++ b/olddocs/js/events.md @@ -1,6 +1,6 @@ # Events Library -The functions in the events namespace allow the BBC micro:bit to communicate with a separate (remote) device, such as a smartphone, over Bluetooth (Smart). The set of supported events will depend on the remote device and the BBC micro:bit apps available for the remote device. The events accessible from Touch Develop are listed below. +The functions in the events namespace allow the @boardname@ to communicate with a separate (remote) device, such as a smartphone, over Bluetooth (Smart). The set of supported events will depend on the remote device and the @boardname@ apps available for the remote device. The events accessible from Touch Develop are listed below. ### Remote control diff --git a/olddocs/js/gallery.md b/olddocs/js/gallery.md index f82a6e55..e4595981 100644 --- a/olddocs/js/gallery.md +++ b/olddocs/js/gallery.md @@ -1,6 +1,6 @@ # Gallery -Overview of Touch Develop lessons for the BBC micro:bit. +Overview of Touch Develop lessons for the @boardname@. ### @short Gallery @@ -9,13 +9,13 @@ Overview of Touch Develop lessons for the BBC micro:bit. ## Maker -* [Telegraph](/pzeagwoudd), play the telegraph game between 2 BBC micro:bits -* [Ornament Chain](/rnvpgo), play the ornament chain game between 2 BBC micro:bits +* [Telegraph](/pzeagwoudd), play the telegraph game between 2 @boardname@s +* [Ornament Chain](/rnvpgo), play the ornament chain game between 2 @boardname@s ### ~hide * [The Watch](/lessons/the-watch), design and create The Watch -* [Hack your headphones](/lessons/hack-your-headphones), create music on the BBC micro:bit by hacking your headphones +* [Hack your headphones](/lessons/hack-your-headphones), create music on the @boardname@ by hacking your headphones * [Banana Keyboard](/lessons/banana-keyboard), create music with fruits ### ~ @@ -51,7 +51,7 @@ Overview of Touch Develop lessons for the BBC micro:bit. * [Truth or dare](/filuzbwauo), a game that forces each player to reveal a secret or do something funny with if statement * [Love meter](/rrmlrvojfa), create a love meter with on pin pressed * [Guess the number](/ftsenbvqwz), guess a random number with random -* [Magic 8](/fyjinpjuqu), a fortune teller game with the BBC micro:bit +* [Magic 8](/fyjinpjuqu), a fortune teller game with the @boardname@ * [Counter](/rerlmjgjut), display a number with a variable * [Glowing pendulum](/xrnsveuwxj), construct a pendulum that glows using acceleration * [Looper](/nxcddtbizi), display a series of numbers with a for loop index @@ -60,7 +60,7 @@ Overview of Touch Develop lessons for the BBC micro:bit. * [Rotation animation](/lessons/rotation-animation), control an animation with a boolean variable * [Offset image](/lessons/offset-image), shift an image horizontally with image offset -* [Compass](/lessons/compass), displays the direction the BBC micro:bit is pointing +* [Compass](/lessons/compass), displays the direction the @boardname@ is pointing ### ~ @@ -74,7 +74,7 @@ Overview of Touch Develop lessons for the BBC micro:bit. * [Headbands](/bzrusu), create a charades game with a collection of strings that hold the words * [Prank WiFi](/dceikq), create fake WiFi to trick your friends * [Flipping bird](/lbhvywjzkv), use modulo with a conditional -* [Runaway pac man](/loafab), construct the game pac man with the BBC micro:bit +* [Runaway pac man](/loafab), construct the game pac man with the @boardname@ * [Line of Fire](/fzcoly), make a game to test hand-eye coordination * [The hat game](/njynsd), make a game to test your focus on the moving ball * [Pong](/xcenyy), a light bouncing from left to right @@ -89,13 +89,13 @@ Overview of Touch Develop lessons for the BBC micro:bit. * [Transformers](/lessons/transformers), use functions to return values * [Speed button](/lessons/speed-button), code a speed game with running time * [Jailbreak](/lessons/jailbreak), break out of a counting loop by pressing button "A" -* [2 player pong](/bzycll), collaborate with a classmate to develop Pong on multiple BBC micro:bits +* [2 player pong](/bzycll), collaborate with a classmate to develop Pong on multiple @boardname@s ### ~ ### ~hide -* [Number psych](/lessons/number-psych), collaborate with multiple classmates to develop a game on multiple BBC micro:bits and a breadboard +* [Number psych](/lessons/number-psych), collaborate with multiple classmates to develop a game on multiple @boardname@s and a breadboard ### ~ diff --git a/olddocs/js/games.md b/olddocs/js/games.md index 529bf681..a201a2f3 100644 --- a/olddocs/js/games.md +++ b/olddocs/js/games.md @@ -1,6 +1,6 @@ # Game Tutorials -Overview of Games for the BBC micro:bit. +Overview of Games for the @boardname@. ### @short Games @@ -41,8 +41,8 @@ Overview of Games for the BBC micro:bit. * [Looper](/lessons/looper/tutorial), display a series of numbers with a for loop index * [Strobe light](/lessons/strobe-light/tutorial), develop shapes with a nested for loops * [Digi yoyo](/lessons/digi-yoyo/tutorial), create a counter with a while loop -* [Magic 8](/lessons/magic-8/tutorial), a fortune teller game with the BBC micro:bit -* [Compass](/lessons/compass/tutorial), displays the direction the BBC micro:bit is pointing +* [Magic 8](/lessons/magic-8/tutorial), a fortune teller game with the @boardname@ +* [Compass](/lessons/compass/tutorial), displays the direction the @boardname@ is pointing * [Speed button](/lessons/speed-button/tutorial), code a speed game with running time ### ~hide @@ -74,15 +74,15 @@ Overview of Games for the BBC micro:bit. * [Bop it](/lessons/bop-it/tutorial), a game where you have to keep up with the commands * [Letter Up](/lessons/letter-up/tutorial), a guessing game with string operators with string at * [Prank WiFi](/lessons/prank-wifi/tutorial), create fake WiFi to trick your friends -* [Runaway pac man](/lessons/runaway-pacman/tutorial), construct the game pac man with the BBC micro:bit +* [Runaway pac man](/lessons/runaway-pacman/tutorial), construct the game pac man with the @boardname@ * [The hat game](/lessons/the-hat-game/tutorial), make a game to test your focus on the moving ball -* [2 player pong](/lessons/2-player-pong/tutorial), collaborate with a classmate to develop Pong on multiple BBC micro:bits +* [2 player pong](/lessons/2-player-pong/tutorial), collaborate with a classmate to develop Pong on multiple @boardname@s ### ~hide * [Glowing pendulum](/lessons/glowing-pendulum/tutorial), construct a pendulum that glows using acceleration * [Line of Fire](/lessons/line-of-fire/tutorial), make a game to test hand-eye coordination -* [Number psych](/lessons/number-psych/tutorial), collaborate with multiple classmates to develop a game on multiple BBC micro:bits and a breadboard +* [Number psych](/lessons/number-psych/tutorial), collaborate with multiple classmates to develop a game on multiple @boardname@s and a breadboard ### ~ diff --git a/olddocs/js/hourofcode.md b/olddocs/js/hourofcode.md index 26a07732..afd7d89d 100644 --- a/olddocs/js/hourofcode.md +++ b/olddocs/js/hourofcode.md @@ -1,14 +1,14 @@ # Hour of Code -learn how to run an Hour Of Code with the BBC micro:bit. #docs +learn how to run an Hour Of Code with the @boardname@. #docs -The BBC micro:bit can be used to run an Hour Of Code™ events for beginner of all ages. This document provides a detailed guidance on how to prepare and deliver the event in your school. +The @boardname@ can be used to run an Hour Of Code™ events for beginner of all ages. This document provides a detailed guidance on how to prepare and deliver the event in your school. ## preparing the room 1) Computers -* Ensure that each participant will have **a computer connected to a BBC micro:bit board via a micro-USB cable**. +* Ensure that each participant will have **a computer connected to a @boardname@ board via a micro-USB cable**. 2) Internet @@ -53,8 +53,8 @@ Print the following **challenges** (1 handout per student): After your Hour Of Code™, you will want to provide plenty of material for students to continue learning about coding. Here are some good places to start: -* [more challenges](/js/games) are available with BBC micro:bit Tutorials -* [the Quick Start Guide for Teachers](http://www.slideshare.net/Microsofteduk/bbc-microbit-guide-from-hodder-education) are available within BBC micro:bit +* [more challenges](/js/games) are available with @boardname@ Tutorials +* [the Quick Start Guide for Teachers](http://www.slideshare.net/Microsofteduk/bbc-microbit-guide-from-hodder-education) are available within @boardname@ The 'Hour of Code™' is a nationwide initiative by [Computer Science Education Week](http://csedweek.org) and [Code.org](http://code.org) to introduce millions of students to one hour of computer science and computer programming. diff --git a/olddocs/js/hourofcode/notes.md b/olddocs/js/hourofcode/notes.md index 06135b5a..2a0ff6c2 100644 --- a/olddocs/js/hourofcode/notes.md +++ b/olddocs/js/hourofcode/notes.md @@ -1,14 +1,14 @@ # Hour of Code notes -learn how to run an Hour Of Code with the BBC micro:bit. #docs +learn how to run an Hour Of Code with the @boardname@. #docs -The BBC micro:bit can be used to run an Hour Of Code™ event for beginner of all ages. This document provides a detailed guidance on how to prepare and deliver the event in your school. +The @boardname@ can be used to run an Hour Of Code™ event for beginner of all ages. This document provides a detailed guidance on how to prepare and deliver the event in your school. ## Preparation 1) Computers -Each participant has **a computer connected to a BBC micro:bit via micro-USB**. +Each participant has **a computer connected to a @boardname@ via micro-USB**. 2) Internet @@ -41,8 +41,8 @@ Bring more energy in the room by playing music. After your Hour Of Code™, you will want to provide plenty of material for students to continue learning about coding. Here are some good places to start: -* [more challenges](/lessonss) are available for BBC micro:bit -* [the Quick Start Guide for Teachers](http://www.slideshare.net/Microsofteduk/bbc-microbit-guide-from-hodder-education) are available within BBC micro:bit +* [more challenges](/lessonss) are available for @boardname@ +* [the Quick Start Guide for Teachers](http://www.slideshare.net/Microsofteduk/bbc-microbit-guide-from-hodder-education) are available within @boardname@ _The Hour of Code™ is a nationwide initiative by [Computer Science Education Week](http://csedweek.org) and [Code.org](http://code.org) to introduce millions of students to one hour of computer science and computer programming._ diff --git a/olddocs/js/lessons.md b/olddocs/js/lessons.md index d3e66d1b..287da301 100644 --- a/olddocs/js/lessons.md +++ b/olddocs/js/lessons.md @@ -1,6 +1,6 @@ # Touch Develop Lessons -Overview of Touch Develop lessons for the BBC micro:bit. +Overview of Touch Develop lessons for the @boardname@. ### @short Lessons @@ -9,10 +9,10 @@ Overview of Touch Develop lessons for the BBC micro:bit. ## Maker * [The Watch](/lessons/the-watch), design and create The Watch -* [Hack your Headphones](/lessons/hack-your-headphones), create music on the BBC micro:bit by hacking your headphones +* [Hack your Headphones](/lessons/hack-your-headphones), create music on the @boardname@ by hacking your headphones * [Banana Keyboard](/lessons/banana-keyboard), create music with fruits -* [Telegraph](/lessons/telegraph), play the telegraph game between 2 BBC micro:bits -* [Ornament Chain](/lessons/ornament-chain), play the ornament chain game between 2 BBC micro:bits +* [Telegraph](/lessons/telegraph), play the telegraph game between 2 @boardname@s +* [Ornament Chain](/lessons/ornament-chain), play the ornament chain game between 2 @boardname@s ## Beginner @@ -33,7 +33,7 @@ Overview of Touch Develop lessons for the BBC micro:bit. ## Intermediate -* [Magic 8](/lessons/magic-8), a fortune teller game with the BBC micro:bit +* [Magic 8](/lessons/magic-8), a fortune teller game with the @boardname@ * [Guess the Number](/lessons/guess-the-number), guess a random number with random * [Rock Paper Scissors](/lessons/rock-paper-scissors), use image offsets with local variables * [Counter](/lessons/counter), display a number with a variable @@ -48,7 +48,7 @@ Overview of Touch Develop lessons for the BBC micro:bit. * [Digi Yoyo](/lessons/digi-yoyo), create a counter with a while loop * [Rotation Animation](/lessons/rotation-animation), control an animation with a boolean variable * [Offset Image](/lessons/offset-image), shift an image horizontally with image offset -* [Compass](/lessons/compass), displays the direction the BBC micro:bit is pointing +* [Compass](/lessons/compass), displays the direction the @boardname@ is pointing ### ~ @@ -64,10 +64,10 @@ Overview of Touch Develop lessons for the BBC micro:bit. * [Prank WiFi](/lessons/prank-wifi), create fake WiFi to trick your friends * [Jailbreak](/lessons/jailbreak), break out of a counting loop by pressing button "A" * [Flipping Bird](/lessons/flipping-bird), use modulo with a conditional -* [Runaway Pac Man](/lessons/runaway-pacman), construct the game pac man with the BBC micro:bit +* [Runaway Pac Man](/lessons/runaway-pacman), construct the game pac man with the @boardname@ * [Line of Fire](/lessons/line-of-fire), make a game to test hand-eye coordination * [The Hat Game](/lessons/the-hat-game), make a game to test your focus on the moving ball -* [2 Player Pong](/lessons/2-player-pong), collaborate with a classmate to develop Pong on multiple BBC micro:bits +* [2 Player Pong](/lessons/2-player-pong), collaborate with a classmate to develop Pong on multiple @boardname@s ### Games @@ -81,7 +81,7 @@ Overview of Touch Develop lessons for the BBC micro:bit. ### ~hide -* [Number Psych](/lessons/number-psych), collaborate with multiple classmates to develop a game on multiple BBC micro:bits and a breadboard +* [Number Psych](/lessons/number-psych), collaborate with multiple classmates to develop a game on multiple @boardname@s and a breadboard ### ~ diff --git a/olddocs/js/lessons/2-player-pong/quiz-answers.md b/olddocs/js/lessons/2-player-pong/quiz-answers.md index 9979f272..f2a09273 100644 --- a/olddocs/js/lessons/2-player-pong/quiz-answers.md +++ b/olddocs/js/lessons/2-player-pong/quiz-answers.md @@ -1,6 +1,6 @@ # 2 player pong quiz answers -a two-player game of Pong using TWO BBC micro:bits!. +a two-player game of Pong using TWO @boardname@s!. ## Name diff --git a/olddocs/js/lessons/2-player-pong/quiz.md b/olddocs/js/lessons/2-player-pong/quiz.md index a764fb06..e55976a4 100644 --- a/olddocs/js/lessons/2-player-pong/quiz.md +++ b/olddocs/js/lessons/2-player-pong/quiz.md @@ -1,6 +1,6 @@ # 2 player pong quiz -a two-player game of Pong using TWO BBC micro:bits!. +a two-player game of Pong using TWO @boardname@s!. ## Name diff --git a/olddocs/js/lessons/digital-pet.md b/olddocs/js/lessons/digital-pet.md index a31255c4..81056623 100644 --- a/olddocs/js/lessons/digital-pet.md +++ b/olddocs/js/lessons/digital-pet.md @@ -1,6 +1,6 @@ # digital pet lesson -a display of pet images for the BBC micro:bit. +a display of pet images for the @boardname@. ## Topic diff --git a/olddocs/js/lessons/digital-pet/quiz-answers.md b/olddocs/js/lessons/digital-pet/quiz-answers.md index ba9649fa..254ef8c5 100644 --- a/olddocs/js/lessons/digital-pet/quiz-answers.md +++ b/olddocs/js/lessons/digital-pet/quiz-answers.md @@ -1,6 +1,6 @@ # digital pet quiz answers -A display of pet images for the BBC micro:bit +A display of pet images for the @boardname@ ## Name diff --git a/olddocs/js/lessons/digital-pet/quiz.md b/olddocs/js/lessons/digital-pet/quiz.md index bf10346b..63936dab 100644 --- a/olddocs/js/lessons/digital-pet/quiz.md +++ b/olddocs/js/lessons/digital-pet/quiz.md @@ -1,6 +1,6 @@ # digital pet quiz -A display of pet images for the BBC micro:bit +A display of pet images for the @boardname@ ## Name diff --git a/olddocs/js/lessons/flipping-bird/quiz-answers.md b/olddocs/js/lessons/flipping-bird/quiz-answers.md index 2b956327..2dcfef42 100644 --- a/olddocs/js/lessons/flipping-bird/quiz-answers.md +++ b/olddocs/js/lessons/flipping-bird/quiz-answers.md @@ -12,7 +12,7 @@ Modulo (or Mod) is the remainder of a division problem. ## 2. Consider the following code -If the rectangle below represents the BBC micro:bit, shade in the LEDs that show the value being stored into the **global variable**, `count`. Explain why that particular area is shaded. +If the rectangle below represents the @boardname@, shade in the LEDs that show the value being stored into the **global variable**, `count`. Explain why that particular area is shaded. ``` count = 1 @@ -38,7 +38,7 @@ count = 12 count = math.mod(count, 5) ``` -If the rectangle below represents the BBC micro:bit, shade in the LEDs that show the value being stored into the **global variable**, `count`. Explain why that particular area is shaded. +If the rectangle below represents the @boardname@, shade in the LEDs that show the value being stored into the **global variable**, `count`. Explain why that particular area is shaded.
diff --git a/olddocs/js/lessons/flipping-bird/quiz.md b/olddocs/js/lessons/flipping-bird/quiz.md index 9017688d..9ede676a 100644 --- a/olddocs/js/lessons/flipping-bird/quiz.md +++ b/olddocs/js/lessons/flipping-bird/quiz.md @@ -14,7 +14,7 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu ## 2. Consider the following directions -If the rectangle below represents the BBC micro:bit, shade in the LEDs that show the value being stored into the **global variable**, `count`. +If the rectangle below represents the @boardname@, shade in the LEDs that show the value being stored into the **global variable**, `count`. ``` count = 1 @@ -28,7 +28,7 @@ count = 1 ## 3. Consider the following code -If the rectangle below represents the BBC micro:bit, shade in the LEDs that show the value being stored into the **global variable**, `count`. Explain why that particular area is shaded. +If the rectangle below represents the @boardname@, shade in the LEDs that show the value being stored into the **global variable**, `count`. Explain why that particular area is shaded. ``` count = 1 @@ -50,7 +50,7 @@ count = 12 count = math.mod(count, 5) ``` -If the rectangle below represents the BBC micro:bit, shade in the LEDs that show the value being stored into the **global variable**, `count`. Explain why that particular area is shaded. +If the rectangle below represents the @boardname@, shade in the LEDs that show the value being stored into the **global variable**, `count`. Explain why that particular area is shaded. ![](/static/mb/empty-microbit.png) diff --git a/olddocs/js/lessons/hack-your-headphones.md b/olddocs/js/lessons/hack-your-headphones.md index b30df49d..296f0b9e 100644 --- a/olddocs/js/lessons/hack-your-headphones.md +++ b/olddocs/js/lessons/hack-your-headphones.md @@ -1,6 +1,6 @@ # hack your headphones lesson -display beautiful images on the BBC micro:bit. +display beautiful images on the @boardname@. ## Topic @@ -16,9 +16,9 @@ Year 7 ## Prior learning/place of lesson in scheme of work -Learn how to convert your BBC micro:bit into a music player using pins P0 and GND, headphones (or speakers), as well as crocodile clips (or spring clips). +Learn how to convert your @boardname@ into a music player using pins P0 and GND, headphones (or speakers), as well as crocodile clips (or spring clips). ## Objectives -* learn how to setup the BBC micro:bit with headphones to play music +* learn how to setup the @boardname@ with headphones to play music diff --git a/olddocs/js/lessons/letter-up.md b/olddocs/js/lessons/letter-up.md index 19fc21be..b3baa480 100644 --- a/olddocs/js/lessons/letter-up.md +++ b/olddocs/js/lessons/letter-up.md @@ -56,7 +56,7 @@ Learn how to create a guessing game with **global variables** `var str: "this is * learn how to show a string on the LED screen * learn how to create a local variable to store data so that you can use it later in your code * learn how to set and change the value of a local variable -* learn how to register an event handler that executes whenever the LED screen is perpendicular to the ground and the BBC micro:bit logo is above the LED screen +* learn how to register an event handler that executes whenever the LED screen is perpendicular to the ground and the @boardname@ logo is above the LED screen * learn how to register an event handler that executes whenever the LED screen is facing the floor * learn how to register an event handler that executes whenever the LED screen is facing the ceiling/sky * learn how to return a random number diff --git a/olddocs/js/lessons/number-psych/quiz-answers.md b/olddocs/js/lessons/number-psych/quiz-answers.md index 3115d7b2..da323bae 100644 --- a/olddocs/js/lessons/number-psych/quiz-answers.md +++ b/olddocs/js/lessons/number-psych/quiz-answers.md @@ -181,7 +181,7 @@ while (true) { } ``` -## 14. Write the code that displays an "X" on the BBC micro:bit if 'result' is 1. Otherwise, display a "check mark". +## 14. Write the code that displays an "X" on the @boardname@ if 'result' is 1. Otherwise, display a "check mark".
diff --git a/olddocs/js/lessons/number-psych/quiz.md b/olddocs/js/lessons/number-psych/quiz.md index 292a4f5b..64020c2f 100644 --- a/olddocs/js/lessons/number-psych/quiz.md +++ b/olddocs/js/lessons/number-psych/quiz.md @@ -108,7 +108,7 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
-## 14. Write the code that displays an "X" on the BBC micro:bit if 'result' is 1. Otherwise, display a "check mark". +## 14. Write the code that displays an "X" on the @boardname@ if 'result' is 1. Otherwise, display a "check mark".
diff --git a/olddocs/js/lessons/screen-wipe/activity.md b/olddocs/js/lessons/screen-wipe/activity.md index 713886c7..de3a7a12 100644 --- a/olddocs/js/lessons/screen-wipe/activity.md +++ b/olddocs/js/lessons/screen-wipe/activity.md @@ -1,10 +1,10 @@ # screen wipe activity -Clear the screen by pressing buttons on the BBC micro:bit. +Clear the screen by pressing buttons on the @boardname@. ### ~avatar avatar -This activity will teach how to clear the screen by pressing button ``A`` on the BBC micro:bit. +This activity will teach how to clear the screen by pressing button ``A`` on the @boardname@. ### ~ @@ -35,7 +35,7 @@ input.onButtonPressed(Button.A, () => { }) // *** ``` -Run the script in the simulator or on the BBC micro:bit to see how this works! +Run the script in the simulator or on the @boardname@ to see how this works! ### ~avatar boothing diff --git a/olddocs/js/lessons/screen-wipe/quiz-answers.md b/olddocs/js/lessons/screen-wipe/quiz-answers.md index 4886d9a7..6c6eb45e 100644 --- a/olddocs/js/lessons/screen-wipe/quiz-answers.md +++ b/olddocs/js/lessons/screen-wipe/quiz-answers.md @@ -4,7 +4,7 @@ clear the screen by pressing the "A" button after an animation has been played. This is the answer key for the [screen wipe quiz](/lessons/screen-wipe/quiz). -## 1. What does the function "clear screen" do on the BBC micro:bit? +## 1. What does the function "clear screen" do on the @boardname@? This function turns off all the LED lights on the LED screen. @@ -24,7 +24,7 @@ basic.showAnimation(` `, 400) ``` -## 3. Write the condition that will detect when the BBC micro:bit is shaken. +## 3. Write the condition that will detect when the @boardname@ is shaken.
@@ -33,7 +33,7 @@ input.onGesture(Gesture.Shake, () => { }) ``` -## 4. Write the code that will clear an animation from the screen after shaking the BBC micro:bit. +## 4. Write the code that will clear an animation from the screen after shaking the @boardname@.
diff --git a/olddocs/js/lessons/screen-wipe/quiz.md b/olddocs/js/lessons/screen-wipe/quiz.md index ba44ec4c..7924842c 100644 --- a/olddocs/js/lessons/screen-wipe/quiz.md +++ b/olddocs/js/lessons/screen-wipe/quiz.md @@ -10,7 +10,7 @@ Use this activity document to guide your work in the [screen wipe tutorial](/les Answer the questions while completing the tutorial. Pay attention to the dialogues! -## 1. What does the function "clear screen" do on the BBC micro:bit? +## 1. What does the function "clear screen" do on the @boardname@?
@@ -20,13 +20,13 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
-## 3. How can the BBC micro:bit detect when it is shaken? +## 3. How can the @boardname@ detect when it is shaken?

-## 4. Write the code that will clear an animation from the screen after shaking the BBC micro:bit. +## 4. Write the code that will clear an animation from the screen after shaking the @boardname@.
diff --git a/olddocs/js/lessons/transformer/quiz.md b/olddocs/js/lessons/transformer/quiz.md index 59b502be..438146a5 100644 --- a/olddocs/js/lessons/transformer/quiz.md +++ b/olddocs/js/lessons/transformer/quiz.md @@ -38,7 +38,7 @@ Write the code to call the function that doubles the input number. (the function ## 6. Consider the following picture -Write the code to show number 20 on the BBC micro:bit. Please add the variable called `doubled` Refer to the finished code on the tutorial. +Write the code to show number 20 on the @boardname@. Please add the variable called `doubled` Refer to the finished code on the tutorial.
diff --git a/olddocs/js/quick-start.md b/olddocs/js/quick-start.md index ed076e5f..f0ec5434 100644 --- a/olddocs/js/quick-start.md +++ b/olddocs/js/quick-start.md @@ -24,11 +24,11 @@ The currently available on-line resources from the Quick Start Guide are the ### Errata -* compilation to the BBC micro:bit now works [off line](/offline), based on a new compiler in the web browser. The text and picture below replaces the text and picture on page 10 of the Guide: +* compilation to the @boardname@ now works [off line](/offline), based on a new compiler in the web browser. The text and picture below replaces the text and picture on page 10 of the Guide: -### How does my program get onto the BBC micro:bit? +### How does my program get onto the @boardname@? -For your program to work on the BBC micro:bit, first it has to be compiled. Compiling means to translate a program into a more efficient computer language. When you hit the compile button on the Microsoft Touch Develop Editor interface, your program is compiled into a hex file that contains the machine code in the instruction set used by the ARM processor that is on your BBC micro:bit. Compiling to ARM machine code actually happens in the web browser, where the code from script is joined with the machine code of the micro:bit runtime. +For your program to work on the @boardname@, first it has to be compiled. Compiling means to translate a program into a more efficient computer language. When you hit the compile button on the Microsoft Touch Develop Editor interface, your program is compiled into a hex file that contains the machine code in the instruction set used by the ARM processor that is on your @boardname@. Compiling to ARM machine code actually happens in the web browser, where the code from script is joined with the machine code of the micro:bit runtime. ![](/static/mb/quick-start-0.png) diff --git a/olddocs/js/reactive.md b/olddocs/js/reactive.md index ea4925dc..00fcfdbc 100644 --- a/olddocs/js/reactive.md +++ b/olddocs/js/reactive.md @@ -1,10 +1,10 @@ -# The BBC micro:bit - a reactive system +# The @boardname@ - a reactive system -The BBC micro:bit is a reactive system. #docs +The @boardname@ is a reactive system. #docs ### Computing systems -What sort of a *computing system* is the BBC micro:bit? +What sort of a *computing system* is the @boardname@? ### ~hint @@ -12,21 +12,21 @@ There are different types of computing systems, to address different kinds of pr ### ~ -The BBC micro:bit is a *reactive system* – it reacts continuously to external events, such as a person pressing the A button of the BBC micro:bit or shaking the device. The reaction to an event may be to perform a computation, update variables, and change the display. After the device reacts to an event, it is ready to react to the next one. If this sounds like a computer game, that’s because most computer games are reactive systems too! +The @boardname@ is a *reactive system* – it reacts continuously to external events, such as a person pressing the A button of the @boardname@ or shaking the device. The reaction to an event may be to perform a computation, update variables, and change the display. After the device reacts to an event, it is ready to react to the next one. If this sounds like a computer game, that’s because most computer games are reactive systems too! ### Responsiveness We want reactive systems to be responsive, which means to react in a timely manner to events. For example, when you play a computer game, it’s frustrating if you press a button to make a character jump, but it doesn’t immediately jump. A delay in reacting, or lack of responsiveness , can be the difference between life and death, both in the real and virtual worlds. -Let’s consider a simple example: you want to program your BBC micro:bit to accurately count the number of times the A button has been pressed and continuously display the current count on the 5x5 [LED screen](/device/screen). Because the LED screen is small, we can only display one digit of a number at a time on it. The [show number](/reference/basic/show-number) function will scroll the digits of a number across the screen so you can read it. +Let’s consider a simple example: you want to program your @boardname@ to accurately count the number of times the A button has been pressed and continuously display the current count on the 5x5 [LED screen](/device/screen). Because the LED screen is small, we can only display one digit of a number at a time on it. The [show number](/reference/basic/show-number) function will scroll the digits of a number across the screen so you can read it. Let’s say that the current count is 42 and the number 42 is scrolling across the LED screen. This means there is some code executing to perform the scroll. So, what should happen if you press the A button during the scroll? It would be a bad idea to ignore the button press, so some code should record the occurrence of the button press. But we just said there already is code running in order to scroll the number 42! If we wait until the code scrolling the 42 has finished to look for a button press, we will miss the button press. We want to avoid this sort of unresponsiveness. ### Concurrency -To be responsive, a reactive system needs to be able to do several things at the same time (concurrently), just like you can. But the BBC micro:bit only has one CPU for executing your program, which means it can only execute one program instruction at a time. On the other hand, it can execute millions of instructions in a single second. This points the way to a solution. +To be responsive, a reactive system needs to be able to do several things at the same time (concurrently), just like you can. But the @boardname@ only has one CPU for executing your program, which means it can only execute one program instruction at a time. On the other hand, it can execute millions of instructions in a single second. This points the way to a solution. -Think about how a motion picture projector works - it projects only 24 frames per second, yet this is good enough to provide the illusion of fluid motion on the screen. The BBC micro:bit can execute millions of instructions per second, so it seems quite possible for the device to both to smoothly scroll the number 42 across the LED screen while looking for button presses and counting them. +Think about how a motion picture projector works - it projects only 24 frames per second, yet this is good enough to provide the illusion of fluid motion on the screen. The @boardname@ can execute millions of instructions per second, so it seems quite possible for the device to both to smoothly scroll the number 42 across the LED screen while looking for button presses and counting them. Let’s think about three sequences of instructions: @@ -44,9 +44,9 @@ The result is that it takes sequence S1 a little longer to complete, due to the As we’ll soon see, there are other choices for how the sequences can be ordered to achieve the desired result. -### The BBC micro:bit scheduler and queuing up subprograms +### The @boardname@ scheduler and queuing up subprograms -The BBC micro:bit’s *scheduler* provides the capability to concurrently execute different code sequences, relieving us of a lot of low-level programming. In fact, scheduling is so useful that it is a part of every *operating system*! +The @boardname@’s *scheduler* provides the capability to concurrently execute different code sequences, relieving us of a lot of low-level programming. In fact, scheduling is so useful that it is a part of every *operating system*! The first job of the scheduler is to allow multiple *subprograms* to be queued up for later execution . For our purposes, a subprogram is just a statement or sequence of statements in the context of a larger program. Consider the Touch Develop program below for counting button presses. @@ -98,7 +98,7 @@ The answer is “cooperation” and “passing”. Think of a football team doi If you hadn’t guessed already, a footballer represents subprogram and dribbling the ball corresponds to that subprogram executing. Only one subprogram gets to execute at a time, as there is only one ball (processor). Footballer Alice passing the ball to footballer Bob corresponds to stopping execution of Alice’s subprogram (and remembering where it stopped) and starting/resuming execution of Bob’s subprogram. -We will call this “passing control of execution” rather than “passing the ball”. However, in the world of the BBC micro:bit, the concurrently executing subprograms are not aware of each other, so they don’t actually pass control directly to one another. Rather they pass control of execution back to the scheduler and the scheduler determines the subprogram to pass control to next. The programmer inserts a call to the `pause` function to indicate a point in the subprogram where control of execution passes to the scheduler. Also, when a subprogram ends execution, control passes to the scheduler. +We will call this “passing control of execution” rather than “passing the ball”. However, in the world of the @boardname@, the concurrently executing subprograms are not aware of each other, so they don’t actually pass control directly to one another. Rather they pass control of execution back to the scheduler and the scheduler determines the subprogram to pass control to next. The programmer inserts a call to the `pause` function to indicate a point in the subprogram where control of execution passes to the scheduler. Also, when a subprogram ends execution, control passes to the scheduler. Let’s take a look at the implementation of the `forever` statement to see an example of cooperative scheduling: @@ -118,7 +118,7 @@ The property of such round-robin scheduling is that under the assumption that ev ### Putting it all together -Let’s go back to the `count button presses` function and revisit its execution based on what we have learned about the BBC micro:bit scheduler. As detailed before, the function executes three steps to: (1) initialize the variable `count` to zero; (2) set up the event handler for each press of button A; (3) queue the forever loop to the run queue. +Let’s go back to the `count button presses` function and revisit its execution based on what we have learned about the @boardname@ scheduler. As detailed before, the function executes three steps to: (1) initialize the variable `count` to zero; (2) set up the event handler for each press of button A; (3) queue the forever loop to the run queue. The function then ends execution and control passes back to the scheduler. Let’s assume the user has not pressed any buttons . The scheduler finds the `forever` loop in the run queue and passes control to it. The loop first calls `basic -> show number(0,150)`. In the diagram below, we use “Show 0” to refer to the execution of this function: @@ -128,7 +128,7 @@ While "Show 0" (the blue sequence) is running, periodic interrupts by the schedu ### Final thoughts -Through this example, we have seen that the BBC micro:bit scheduler enables you to create a program that is composed of concurrent subprograms. In essence, the programmer needs to only think about the concurrent subprograms cooperatively passing control back to the scheduler, making sure no subprogram hogs control (or “dribbles the ball without passing”) for too long. While a subprogram runs, the scheduler polls the buttons and other IO peripherals at a high frequency in order to fire off events and queue event handlers for later execution, but this is invisible to the programmer. +Through this example, we have seen that the @boardname@ scheduler enables you to create a program that is composed of concurrent subprograms. In essence, the programmer needs to only think about the concurrent subprograms cooperatively passing control back to the scheduler, making sure no subprogram hogs control (or “dribbles the ball without passing”) for too long. While a subprogram runs, the scheduler polls the buttons and other IO peripherals at a high frequency in order to fire off events and queue event handlers for later execution, but this is invisible to the programmer. As a result, you can easily add a new capability to the micro:bit by just adding a new subprogram. For example, if you want to add a reset feature to the counter program, all you need to do is add a new event handler for a press of button B that sets the global variable "count" to zero, as shown below: diff --git a/olddocs/js/serial-library.md b/olddocs/js/serial-library.md index 36e5a55d..7280ab88 100644 --- a/olddocs/js/serial-library.md +++ b/olddocs/js/serial-library.md @@ -2,9 +2,9 @@ The serial library #docs -The **serial library** supports [serial communication](https://en.wikipedia.org/wiki/Serial_port) between the BBC micro:bit and another computer. Basically, this allows you to send data from the micro:bit to your own computer. This is very useful for debugging purposes: you can add `write line` statements in your code and see them display on your computer as the program executes. +The **serial library** supports [serial communication](https://en.wikipedia.org/wiki/Serial_port) between the @boardname@ and another computer. Basically, this allows you to send data from the micro:bit to your own computer. This is very useful for debugging purposes: you can add `write line` statements in your code and see them display on your computer as the program executes. -The code below shows a simple script that sends a line when the BBC micro:bit starts and another line each time the button ``A`` is pressed. +The code below shows a simple script that sends a line when the @boardname@ starts and another line each time the button ``A`` is pressed. ``` serial.writeLine("started...") diff --git a/olddocs/js/showcase.md b/olddocs/js/showcase.md index f73ffe4f..18a26319 100644 --- a/olddocs/js/showcase.md +++ b/olddocs/js/showcase.md @@ -4,7 +4,7 @@ ## Get Started with These Hex Files! -If you have a BBC micro:bit and would like to explore a few scripts, we've created the following hex files for you to copy to your BBC micro:bit +If you have a @boardname@ and would like to explore a few scripts, we've created the following hex files for you to copy to your @boardname@ ### Flashing Heart diff --git a/olddocs/js/simulator.md b/olddocs/js/simulator.md index d497c595..d35401fb 100644 --- a/olddocs/js/simulator.md +++ b/olddocs/js/simulator.md @@ -6,21 +6,21 @@ While you're writing and testing your scripts, you'll mostly be running scripts *Note*: in the Touch Develop editor, the button actually is named `run main`, reflecting the fact that execution of a Touch Develop script always beings in the `main` function -When you click `run main` in the Touch Develop editor, your code executes and the results are simulated on-screen, using an image of the BBC micro:bit device, like this: +When you click `run main` in the Touch Develop editor, your code executes and the results are simulated on-screen, using an image of the @boardname@ device, like this: -In the picture above, [plot image](/reference/led/plot-image) create a heart image that appears on the BBC micro:bit simulator. +In the picture above, [plot image](/reference/led/plot-image) create a heart image that appears on the @boardname@ simulator. -The BBC micro:bit simulator let's you... +The @boardname@ simulator let's you... -* write and test code, even if you don't have a BBC micro:bit device -* test your code throughly before downloading and running your script on the BBC micro:bit +* write and test code, even if you don't have a @boardname@ device +* test your code throughly before downloading and running your script on the @boardname@ ### What does the simulator support? -The BBC micro:bit simulator supports the Touch Develop [functions](/js/contents) and Microsoft [blocks](/blocks/contents), including those related to the LED screen, input buttons, the compass, accelerometer, and the digital I/O pins. +The @boardname@ simulator supports the Touch Develop [functions](/js/contents) and Microsoft [blocks](/blocks/contents), including those related to the LED screen, input buttons, the compass, accelerometer, and the digital I/O pins. -* **LED screen**: the [LED screen](/device/screen) that appears on-screen shows you what you'll see on the BBC micro:bit device +* **LED screen**: the [LED screen](/device/screen) that appears on-screen shows you what you'll see on the @boardname@ device * **input buttons**: when running code with [button is pressed](/reference/input/button-is-pressed) or [on button pressed](/reference/input/on-button-pressed) functions, click the on-screen A or B button * **compass**: when running code that includes [compass heading](/reference/input/compass-heading), click and drag the on-screen compass needle to change the heading * **accelerometer**: move your mouse over the on-screen micro:bit device to simulate [acceleration](/reference/input/acceleration). The x and y axis values are shown on-screen. @@ -32,11 +32,11 @@ If you click on the white THEME button in the top right corner of the simulator, ### All done? -Once you're done writing and testing your code on the simulator, compile and run your script on your BBC micro:bit device. To find out how to do this, see [run scripts on the micro:bit](/device/usb). +Once you're done writing and testing your code on the simulator, compile and run your script on your @boardname@ device. To find out how to do this, see [run scripts on the micro:bit](/device/usb). ### Simulator vs micro:bit -Running your scripts in a web browser is a *simulation* of how your code will run on the BBC micro:bit device. When you run your script on your BBC micro:bit device, the results may differ slightly. For example, the timing may be subtly different when your script runs on the BBC micro:bit device (you may need to adjust your [pause](/reference/basic/pause) functions). For this reason, be sure to test your scripts on the BBC micro:bit device. +Running your scripts in a web browser is a *simulation* of how your code will run on the @boardname@ device. When you run your script on your @boardname@ device, the results may differ slightly. For example, the timing may be subtly different when your script runs on the @boardname@ device (you may need to adjust your [pause](/reference/basic/pause) functions). For this reason, be sure to test your scripts on the @boardname@ device. ### See also diff --git a/olddocs/js/string-functions.md b/olddocs/js/string-functions.md index d3986464..73ba8f39 100644 --- a/olddocs/js/string-functions.md +++ b/olddocs/js/string-functions.md @@ -4,7 +4,7 @@ string-related functions. ### @parent js/language -The following string related functions are available in Touch Develop for the BBC micro:bit: +The following string related functions are available in Touch Develop for the @boardname@: * **equals** - find out if two strings are the same * **at** - get a character within a string diff --git a/olddocs/js/string.md b/olddocs/js/string.md index 1331d410..1e7230bc 100644 --- a/olddocs/js/string.md +++ b/olddocs/js/string.md @@ -4,7 +4,7 @@ a piece of text. ### @parent js/language -A *String* is a sequence of characters. For the BBC micro:bit, ASCII character codes 32 to 126 are supported; letters, digits, punctuation marks, and a few symbols. All other character codes appear as a ? on the [LED screen](/device/screen). +A *String* is a sequence of characters. For the @boardname@, ASCII character codes 32 to 126 are supported; letters, digits, punctuation marks, and a few symbols. All other character codes appear as a ? on the [LED screen](/device/screen). ### Declare a string diff --git a/olddocs/js/types.md b/olddocs/js/types.md index 6b84ccd7..e9eee5b8 100644 --- a/olddocs/js/types.md +++ b/olddocs/js/types.md @@ -5,7 +5,7 @@ Touch Develop types. ### @parent language -A *type* refers to a class of data and the operations permitted on that data. The following types are supported by Touch Develop for the BBC micro:bit: +A *type* refers to a class of data and the operations permitted on that data. The following types are supported by Touch Develop for the @boardname@: * **[String](/reference/types/string)**: a sequence of characters * **[Number](/reference/types/number)**: an integer number (32-bit signed)