Optimised images with calibre/image-actions

* updated pauseuntil

* updated youtube link

* updated docs

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,35 @@
+---
+name: Bug report
+about: Create a report to help us improve
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+Add screenshots to help explain your problem. You can copy paste the screenshot in the github report. The .gif screen recording is very useful as well. 
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,17 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/calibreapp-image-actions.yml

@@ -0,0 +1,12 @@
+name: Compress images
+on: pull_request
+jobs:
+  build:
+    name: calibreapp/image-actions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@master
+      - name: calibreapp/image-actions
+        uses: docker://calibreapp/github-image-actions
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.travis.yml

@@ -0,0 +1,9 @@
+language: node_js
+node_js:
+  - "8.9.0"
+script:
+  - "node node_modules/pxt-core/built/pxt.js travis"
+sudo: false
+cache:
+  directories:
+    - node_modules

README.md

@@ -1,13 +1,8 @@
-# LEGO Mindstorms EV3 target for PXT
+# LEGO® MINDSTORMS® Education EV3 for Microsoft MakeCode [![Build Status](https://travis-ci.org/microsoft/pxt-ev3.svg?branch=master)](https://travis-ci.org/microsoft/pxt-ev3)
 
-[![Build Status](https://ci2.dot.net/buildStatus/icon?job=Private/pxt_project_rainbow/master/pxt-ev3_Push)](https://ci2.dot.net/job/Private/job/pxt_project_rainbow/job/master/job/pxt-ev3_Push/)
+This repo contains the editor target hosted at https://makecode.mindstorms.com
 
-This repo contains the editor target hosted at https://makecode.legoeducation.com
-
-LEGO Auth: https://src.education.lego.com/groups/ev3-makecode (use Google Authenticator)
-LEGO Chat: https://chat.internal.education.lego.com/make-code/channels/town-square
-
-## Local Dev setup
+## Local setup
 
 These instructions assume familiarity with dev tools and languages.
 
@@ -15,18 +10,25 @@ These instructions assume familiarity with dev tools and languages.
 * install Docker; make sure `docker` command is in your `PATH`
 * (optional) install [Visual Studio Code](https://code.visualstudio.com/)
 
-In a common folder,
-
-* clone https://github.com/Microsoft/pxt to ``pxt`` folder
-* clone https://github.com/Microsoft/pxt-common-packages to ``pxt-common-packages`` folder
 * clone https://github.com/Microsoft/pxt-ev3 to ``pxt-ev3`` folder
 * go to ``pxt`` and run
 
 ```
 npm install
-typings install
 ```
 
+* to run the local server,
+```
+pxt serve --cloud
+```
+
+## Local Dev setup
+
+In the common folder,
+
+* clone https://github.com/Microsoft/pxt to ``pxt`` folder
+* clone https://github.com/Microsoft/pxt-common-packages to ``pxt-common-packages`` folder
+
 * go to ``pxt-common-packages`` and run
 
 ```
@@ -58,12 +60,12 @@ cd libs/core
 pxt deploy
 ```
 
-### Jenkins build
-https://ci2.dot.net/job/Private/job/pxt_project_rainbow/job/master/
-
 ## License
 MIT
 
+## Trademarks
+MICROSOFT, the Microsoft Logo, and MAKECODE are registered trademarks of Microsoft Corporation. They can only be used for the purposes described in and in accordance with Microsoft’s Trademark and Brand guidelines published at https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. If the use is not covered in Microsoft’s published guidelines or you are not sure, please consult your legal counsel or the MakeCode team (makecode@microsoft.com). 
+
 ## Code of Conduct
 
 This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.

cmds/pxtrequire.ts

@@ -1,6 +0,0 @@
-/// <reference path="../node_modules/pxt-core/built/pxtlib.d.ts" />
-
-import * as path from "path";
-export let pxtCore = require("pxt-core");
-// require.resolve() gives path to [pxt dir]/built/pxt.js, so move up twice to get pxt root dir
-export let pxtCoreDir = path.resolve(require.resolve("pxt-core"), "..", "..");

docfiles/footer.html

@@ -0,0 +1,18 @@
+<footer class="ui vertical footer segment hideprint" aria-hidden="false">
+    <div class="ui center aligned container">
+        <div class="ui section divider"></div>
+        <div class="ui container horizontal small divided link list">
+            <!-- <a class="item" href="https://makecode.com/contact" target="_blank" rel="noopener">Contact Us</a> -->
+            <a class="item" href="https://makecode.com/privacy" target="_blank" rel="noopener">Privacy &amp; Cookies</a>
+            <a class="item" href="https://makecode.com/termsofuse" target="_blank" rel="noopener"> Terms Of Use</a>
+            <a class="item" href="https://makecode.com/trademarks" target="_blank" rel="noopener">Trademarks</a>
+            <div class="item">© 2018 Microsoft</div>
+        </div>
+        <div class="ui container horizontal small divided link list">
+            <a class="ui centered item" href="https://makecode.com/" title="Microsoft MakeCode" target="_blank" rel="noopener">Powered by Microsoft MakeCode</a>
+        </div>
+        <div class="ui centered container small list">
+            <p class="item">LEGO, the LEGO logo, MINDSTORMS and the MINDSTORMS EV3 logo are trademarks and/ or copyrights of the LEGO Group. ©2018 The LEGO Group. All rights reserved.</p>
+        </div>
+    </div>
+</footer>

docs/SUMMARY.md

@@ -1,15 +1,41 @@
 # @extends
 
+## Support #support
+
+* [Troubleshoot](/troubleshoot)
+* [EV3 Manager](https://ev3manager.education.lego.com/)
+* [Bluetooth](/bluetooth)
+* [Forum](https://forum.makecode.com)
+* [LEGO Support](https://www.lego.com/service/)
+* [FIRST LEGO League](/fll)
+
 ## Projects #projects
 
 * [Getting Started](/getting-started)
     * [Try](/getting-started/try)
     * [Use](/getting-started/use)
 
+* [Tutorials](/tutorials)
+    * [Wake Up!](/tutorials/wake-up)
+    * [Make An Animation](/tutorials/make-an-animation)
+    * [What Animal Am I?](/tutorials/what-animal-am-i)
+    * [Music Brick](/tutorials/music-brick)
+    * [Run Motors](/tutorials/run-motors)
+    * [Tank ZigZag](/tutorials/tank-zigzag)
+    * [Touch to Run](/tutorials/touch-to-run)
+    * [Touch Sensor Values](/tutorials/touch-sensor-values)
+    * [What Color?](/tutorials/what-color)
+    * [Line Following](/tutorials/line-following)
+    * [Red Light, Green Light](/tutorials/redlight-greenlight)
+    * [Reflected Light Measure](/tutorials/reflected-light-measure)
+    * [Reflected Light Calibration](/tutorials/reflected-light-calibration)
+    * [Object Near?](/tutorials/object-near)
+    * [Security Alert](/tutorials/security-alert)
+
 * [Coding](/coding)
     * [Autonomous Parking](/coding/autonomous-parking)
     * [Object Detection](/coding/object-detection)
-    * [Line Following](/coding/line-following)
+    * [Line Detection](/coding/line-detection)
         
 * [Design Engineering](/design-engineering)
     * [Make It Move Without Wheels](/design-engineering/make-it-move)
@@ -18,37 +44,7 @@
 
 * [Maker](/maker)
     * [Make a Sound Machine](/maker/sound-machine)
-
-* [Examples](/examples)
-    * [Make it move](/lessons/make-it-move)
-    * [Line detection](/lessons/line-detection)
-    * [Sound of Color](/maker/sound-of-color)
-    * [Security Gadget](/maker/security-gadget)
-    * [Intruder detector](/maker/intruder-detector)
-    * [Puppet](/maker/puppet)
-    * [Three Point Turn 1](/coding/three-point-turn-1)
-    * [Three Point Turn 2](/coding/three-point-turn-2)
-    * [Three Point Turn 3](/coding/three-point-turn-3)
-    * [Reversing the robot 1](/coding/reversing-the-robot-1)
-    * [Reversing the robot 2](/coding/reversing-the-robot-2)
-    * [Reversing the robot 3](/coding/reversing-the-robot-3)
-    * [Light the way 1](/coding/light-the-way-1)
-    * [Light the way 2](/coding/light-the-way-2)
-    * [Light the way 3](/coding/light-the-way-3)
-    * [Traffic Lights 1](/coding/traffic-lights-1)
-    * [Traffic Lights 2](/coding/traffic-lights-2)
-    * [Traffic Lights 3](/coding/traffic-lights-3)
-    * [Reverse Beeper 1](/coding/reverse-beeper-1)
-    * [Reverse Beeper 2](/coding/reverse-beeper-2)
-    * [Reverse Beeper 3](/coding/reverse-beeper-3)
-    * [Ignition 1](/coding/ignition-1)
-    * [Ignition 2](/coding/ignition-2)
-    * [Ignition 3](/coding/ignition-3)
-    * [Cruise Control 1](/coding/cruise-control-1)
-    * [Cruise Control 2](/coding/cruise-control-2)
-    * [Cruise Control 3](/coding/cruise-control-3)
-    * [Roaming 1](/coding/roaming-1)
-    * [Roaming 2](/coding/roaming-2)
+    * [Make a Security Gadget](/maker/security-gadget)
 
 ## Reference #reference
 
@@ -60,6 +56,7 @@
         * [show mood](/reference/brick/show-mood)
         * [show image](/reference/brick/show-image)
         * [clear screen](/reference/brick/clear-screen)
+        * [show ports](/reference/brick/show-ports)
         * [on event](/reference/brick/button/on-event)
         * [is pressed](/reference/brick/button/is-pressed)
         * [was pressed](/reference/brick/button/was-pressed)
@@ -75,7 +72,6 @@
         * [set regulated](/reference/motors/motor/set-regulated)
         * [tank](/reference/motors/synced/tank)
         * [steer](/reference/motors/synced/steer)
-        * [tacho](/reference/motors/motor/tacho)
         * [angle](/reference/motors/motor/angle)
         * [speed](/reference/motors/motor/speed)
         * [clear counts](/reference/motors/motor/clear-counts)
@@ -92,12 +88,12 @@
             * [reset](/reference/sensors/gyro/reset)
         * [Ultrasonic](/reference/sensors/ultrasonic)
             * [on event](/reference/sensors/ultrasonic/on-event)
-            * [distance](reference/sensors/ultrasonic/distance)
-            * [pause until](reference/sensors/ultrasonic/pause-until)
+            * [distance](/reference/sensors/ultrasonic/distance)
+            * [pause until](/reference/sensors/ultrasonic/pause-until)
         * [Infrared](/reference/sensors/infrared)
             * [on event](/reference/sensors/infrared/on-event)
-            * [distance](reference/sensors/infrared/proximity)
-            * [pause until](reference/sensors/infrared/pause-until)
+            * [distance](/reference/sensors/infrared/proximity)
+            * [pause until](/reference/sensors/infrared/pause-until)
         * [Infrared beacon](/reference/sensors/beacon)
             * [on event](/reference/sensors/beacon/on-event)
             * [pause until](/reference/sensors/beacon/pause-until)
@@ -106,9 +102,9 @@
             * [set remote channel](/reference/sensors/beacon/set-remote-channel)
         * [Color](/reference/sensors/color-sensor)
             * [on color detected](/reference/sensors/color-sensor/on-color-detected)
-            * [pause for color](/reference/sensors/color-sensor/pause-for-color)
-            * [on light changed](/reference/sensors/color-sensor/on-light-changed)
-            * [pause for light](/reference/sensors/color-sensor/pause-for-light)
+            * [pause until color detected](/reference/sensors/color-sensor/pause-until-color-detected)
+            * [on light detected](/reference/sensors/color-sensor/on-light-detected)
+            * [pause until light condition detected](/reference/sensors/color-sensor/pause-until-light-detected)
             * [color](/reference/sensors/color-sensor/color)
             * [light](/reference/sensors/color-sensor/ambient-light)
     * [Music](/reference/music)
@@ -133,3 +129,7 @@
         * [log](/reference/console/log)
         * [log value](/reference/console/log-value)
         * [send to screen](/reference/console/send-to-screen)
+
+## #misc
+
+## devs

docs/about.md

@@ -17,23 +17,31 @@ brick.buttonEnter.onEvent(ButtonEvent.Bumped, () => {
 })
 ```
 
-The editor work in [most modern browsers](/browsers), work [offline](/offline) once loaded and do not require any installation. 
+The editor works in [most modern browsers](/browsers). It works [offline](/offline) once loaded and doesn't require any installation. Take a look at some of the [features](/about/editor-features) of the editor.
 
 ## Compile and Flash: Your Program!
 
-When you have your code ready, you connect your @boardname@ to a computer via a USB cable 
-so it appears as a mounted drive (named **EV3**). 
+When you have your code ready, you connect your EV3 Brick to a computer with a USB cable so it appears as an attached drive (named **@drivename@**). 
 
 Compilation to machine code from [Blocks](/blocks) or [JavaScript](/javascript) happens in the browser. You save the binary 
-program to a **.uf2** file, which you then copy to the **EV3** drive, which flashes the device with the new program.
+program to a **.uf2** file, which you then copy to the **@drivename@** drive. The process of copying will flash the device with the new program.
+
+### ~ hint
+
+**Experimental support** for Bluetooth download is now available. Please read the [Bluetooth](/bluetooth) page for more information.
+
+### ~
 
 ## Simulator: Test Your Code
 
-You can run your code using the micro:bit simulator, all within the confines of a web browser. 
-The simulator has support for the LED screen, buttons, as well as compass, accelerometer, and digital I/O pins.
+You can run your code using the @boardname@ simulator, all inside the same browser window. 
+The simulator has support for the EV3 Brick screen, buttons, sensors, and motors.
 
 ```sim
 brick.buttonEnter.onEvent(ButtonEvent.Bumped, () => {
     motors.largeA.run(50)
+    motors.mediumD.run(50)
+    sensors.touch1.pauseUntil(ButtonEvent.Pressed)
+    sensors.ultrasonic4.pauseUntil(UltrasonicSensorEvent.ObjectDetected)
 })
-```
+```

docs/about/editor-features.md

@@ -0,0 +1,81 @@
+# @extends
+
+#### #blocks-images
+
+| |
+|-|
+| ![Blocks Toolbox with Loops shelf open](/static/about/blocks-toolbox.png) |
+| Blocks Toolbox |
+
+#### #home-images
+
+| |
+|-|
+| ![Home button](/static/about/home-button.png) |
+| Home Button |
+
+#### #share-images
+
+| |
+|-|
+| ![Share button](/static/about/share-button.png) |
+| Share Button |
+
+#### #blocksjs-images
+
+| |
+|-|
+| ![Switch from Blocks to JavaScript](/static/about/blocks-to-js.gif) |
+| Switch from Blocks to JavaScript |
+
+#### #help-images
+
+| |
+|-|
+| ![Help button](/static/about/help-button.png) |
+| Help Button |
+
+#### #moresettings-images
+
+| |
+|-|
+| ![More settings button](/static/about/more-settings.png) |
+| More Button |
+
+#### #undoredo-images
+
+| | | |
+|-|-|-|
+| ![Undo button](/static/about/undo-button.png) | | ![Redo button](/static/about/redo-button.png) |
+| Undo Button | | Redo Button |
+
+#### #zoom-images
+
+| | | |
+|-|-|-|
+| ![Zoom in button](/static/about/zoom-in.png) | | ![Zoom out button](/static/about/zoom-out.png) |
+| Zoom In | | Zoom Out |
+
+#### #saveproject-images
+
+| |
+|-|
+| ![Save project field](/static/about/save-project.png) |
+| Save Project |
+
+#### #download-images
+
+| |
+|-|
+| ![Download button](/static/about/download-button.png) |
+| Download Button |
+
+#### #explorer-images
+
+| |
+|-|
+| ![Explorer button](/static/about/explorer-button.png) |
+| Explorer Button |
+|   |
+| ![Explorer File View](/static/about/explorer-view.png) |
+| Explorer File View |

docs/bluetooth.md

@@ -0,0 +1,62 @@
+# Bluetooth
+
+This page describes the procedure to download MakeCode program to the EV3 brick 
+over Bluetooth.
+
+## ~ hint
+
+### WARNING: EXPERIMENTAL FEATURES AHEAD! 
+
+Support for Bluetooth download relies on [Web Serial](https://wicg.github.io/serial/),
+an experimental browser feature. Web Serial is a work [in progress](https://www.chromestatus.com/feature/6577673212002304); 
+it may change or be removed in future versions without notice.
+
+By enabling these experimental browser features, you could lose browser data or compromise your device security 
+or privacy.
+
+## ~
+
+https://youtu.be/VIq8-6Egtqs
+
+## Supported browsers
+
+* Chrome desktop, version 77 and higher, Windows 10 or Mac OS.
+* [Edge Insider desktop](https://www.microsoftedgeinsider.com), version 77 and higher, Windows 10 or Mac OS.
+
+To make sure your browser is up to date, go to the '...' menu, click "Help" then "About".
+
+Next you need to enable the experimental features (this may change in the future)
+
+* go to **chrome://flags/#enable-experimental-web-platform-features** and **enable** 
+**Experimental Web Platform features**
+
+![A screenshot of the flags page in chrome](/static/bluetooth/experimental.png)
+
+## Machine Setup
+
+* pair your EV3 brick with your computer over Bluetooth. This is the usual pairing procedure.
+
+## Download over Bluetooth
+
+* go to https://makecode.mindstorms.com/
+* click on **Download** to start a file download as usual
+* on the download dialog, you should see a **Bluetooth** button. Click on the
+**Bluetooth** button to enable the mode.
+* **make sure the EV3 brick is not running a program**
+* click on **Download** again to download over bluetooth.
+
+## Choosing the correct serial port
+
+Unfortunately, the browser dialog does not make it easy to select which serial port is the brick.
+
+* On Windows, choose ``Standard Serial over Bluetooth``. There might be multiple of those but only one works. Try your luck! Once you know the COM port number, remember it for the next time around.
+* On Mac OS, choose ``cu.BRICKNAME-SerialPort``
+
+## Known issues
+
+* We do not detect properly that the program is running on the brick. Make sure to stop the program before starting the download procedure.
+* The list of programs on the brick screen is not updated when uploading via bluetooth.
+
+## Feedback
+
+Please send us your feedback through https://forum.makecode.com.

docs/coding.md

@@ -7,18 +7,21 @@
 [
 {
   "name": "Autonomous Parking",
-  "description": "TBD",
+  "description": "Design cars that can park themselves safely without driver intervention.",
   "url":"/coding/autonomous-parking",
+  "imageUrl": "/static/lessons/autonomous-parking.png",
   "cardType": "side"
 }, {
   "name": "Object Detection",
-  "description": "TBD",
+  "description": "Design ways to avoid accidents between vehicles and objects in the road.",
   "url":"/coding/object-detection",
+  "imageUrl": "/static/lessons/object-detection.jpg",
   "cardType": "side"
 }, {
-  "name": "Line Following",
-  "description": "TBD",
-  "url":"/coding/line-following",
+  "name": "Line Detection",
+  "description": "Design ways to improve driving safety by helping to prevent drivers from falling asleep and causing an accident.",
+  "url":"/coding/line-detection",
+  "imageUrl": "/static/lessons/line-detection.jpg",
   "cardType": "side"
 }]
 ```

docs/coding/autonomous-parking.md

@@ -0,0 +1,177 @@
+# Autonomous Parking
+
+Design cars that can park themselves safely without driver intervention.
+
+![Autonomous parking graphic](/static/coding/autonomous-parking/auto-parking-connect.jpg)
+
+## Connect
+
+**Think about:**
+
+* How do autonomous cars work?
+* What would it take to ensure that autonomous cars are safe?
+* What types of movements do autonomous cars need to perform?
+
+## Construct
+
+### Build
+
+Build a @boardname@ vehicle that can park itself safely without driver intervention. Start by constructing this model:
+
+[![EV3- Robot Driving Base](/static/coding/autonomous-parking/ev3-robot-driving-base.jpg)](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-rem-driving-base-79bebfc16bd491186ea9c9069842155e.pdf)
+
+### ~hint
+
+If clicking the above image doesn't open the instructions, right-click on the image and choose "Save link as..." to download the PDF.
+
+### ~
+
+### Check
+
+Before you program, check:
+
+* Are all the wires correctly connected from the motors to ports B and C?
+* Are the wheels correctly installed?
+* Are the wheels rotating freely?
+
+### Program
+
+Write a program that will make the robot turn three times in various ways.
+
+**Think about:**
+
+* How will you make the robot turn in different ways?
+* How can the robot make a three point turn?
+
+### ~hint
+
+Consider using these blocks in your solution:
+
+```block
+motors.largeBC.tank(50, 50)
+pause(500)
+```
+
+### ~
+
+### Sample Solution - Three Point Turn
+
+1. When the brick button is pressed, turn the driving base right and stop after 1.5 seconds.
+2. Turn the driving base left and stop after 1 second.
+3. Move the driving base forward for 3 seconds.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeBC.tank(75, 30)
+    loops.pause(1500)
+    motors.largeBC.tank(-30, -75)
+    loops.pause(1000)
+    motors.largeBC.tank(50, 50)
+    loops.pause(3000)
+})
+```
+
+### Download and test
+
+Click Download and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+## Contemplate
+
+Choose one of the following autonomous driving scenarios and create a program for it:
+
+* Parallel parking
+* Angle parking
+* Perpendicular parking
+
+### ~hint
+
+Document pseudocode for your program before choosing programming blocks.
+
+### ~
+
+### Sample Solution - Parallel Parking
+
+1. When the brick button is pressed, drive forward in a straight line for 3 rotations.
+2. Wait for 1 second.
+3. Reverse motor rotation while turning for 1.5 rotations.
+4. Reverse motor rotation while turning the other way for 1.5 rotations.
+5. Drive backward in a straight line for 0.5 rotations.
+6. Drive forward in a straight line for 0.5 rotations.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeBC.steer(0, 50, 3, MoveUnit.Rotations)
+    pause(1000)
+motors.largeBC.steer(-50, -50, 1.5, MoveUnit.Rotations)
+    motors.largeBC.steer(50, -50, 1.5, MoveUnit.Rotations)
+    motors.largeBC.steer(0, -50, 0.5, MoveUnit.Rotations)
+    motors.largeBC.steer(0, 50, 0.5, MoveUnit.Rotations)
+})
+```
+
+### Download and test
+
+Click Download and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+### Differentiation
+
+Create a program that simulates displaying appropriate warning lights while parking.
+
+### ~hint
+
+Consider using this block in your solution:
+
+```block
+brick.setStatusLight(StatusLight.OrangeFlash)
+```
+
+### ~
+
+### Sample Solution - Simulating Reverse Gear and Reverse Warning Lights
+
+1. When the brick button is pressed, drive forward in a straight line for 3 rotations.
+2. Wait for 1 second.
+3. Set brick status light to orange flash.
+4. Reverse motor rotation while turning for 1.5 rotations.
+5. Reverse motor rotation while turning the other way for 1.5 rotations.
+6. Drive backward in a straight line for 0.5 rotations.
+7. Set brick status light to off.
+8. Drive forward in a straight line for 0.5 rotations.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeBC.steer(0, 50, 3, MoveUnit.Rotations)
+    pause(1000)
+    brick.setStatusLight(StatusLight.OrangeFlash)
+    motors.largeBC.steer(-50, -50, 1.5, MoveUnit.Rotations)
+    motors.largeBC.steer(50, -50, 1.5, MoveUnit.Rotations)
+    motors.largeBC.steer(0, -50, 0.5, MoveUnit.Rotations)
+    brick.setStatusLight(StatusLight.Off)
+    motors.largeBC.steer(0, 50, 0.5, MoveUnit.Rotations)
+})
+```
+
+### Download and test
+
+Click Download and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+### Share
+
+**Think about:**
+
+* What challenged you?
+* Were there any surprises?
+* How can you improve your program?
+* Can your program be more streamlined? Have you used too many blocks?
+* Is there a more efficient way to build your program?
+* How can your program be used in real-world scenarios?
+
+## Continue
+
+* Click on the JavaScript tab and experiment with changing the values in the code.
+* Add a custom image or sounds from the Brick or Music menus.
+* Create a video of your project, especially your final presentation and your robot’s performance. Explain some important features of your software program.
+* Include an image of your program with comments.
+* Add a team photograph!
+
+Congratulations! What will you design next?

docs/coding/cruise-control-1.md

@@ -1,10 +0,0 @@
-# Cruise Control Activity 1
-
-```blocks
-let speed = 0;
-sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
-    if (speed < 100)
-        speed = speed + 10;
-    motors.largeBC.run(speed);
-}) 
-```

docs/coding/cruise-control-2.md

@@ -1,15 +0,0 @@
-# Cruise Control Activity 2
-
-```blocks
-let speed = 0;
-sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
-    if (speed < 100)
-        speed = speed + 10;
-    motors.largeBC.run(speed);
-}) 
-sensors.touch2.onEvent(ButtonEvent.Pressed, function () {
-    if (speed > -100)
-        speed = speed - 10;
-    motors.largeBC.run(speed);
-}) 
-```

docs/coding/cruise-control-3.md

@@ -1,28 +0,0 @@
-# Cruise Control Activity 3
-
-```blocks
-let speed = 0
-function decelerate() {
-    if (speed > -100) {
-        speed = speed - 10
-    }
-}
-function accelerate() {
-    if (speed < 100) {
-        speed = speed + 10
-    }
-}
-function update() {
-    brick.clearScreen()
-    brick.showString("speed: " + speed, 1)
-    motors.largeBC.run(speed)
-}
-sensors.touch2.onEvent(ButtonEvent.Pressed, function () {
-    accelerate()
-    update()
-})
-sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
-    decelerate()
-    update()
-})
-```

docs/coding/cruise-control.md

@@ -0,0 +1,65 @@
+# Cruise Control
+
+Learn how to set and adjust motor speeds.
+
+## Activity 1
+
+Increase motor speed when touch sensor `1` is pressed.
+
+```blocks
+let speed = 0;
+sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
+    if (speed < 100)
+        speed = speed + 10;
+    motors.largeBC.run(speed);
+}) 
+```
+
+## Activity 2
+
+Add a "reduce" motor speed action when touch sensor `2` is pressed.
+
+```blocks
+let speed = 0;
+sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
+    if (speed < 100)
+        speed = speed + 10;
+    motors.largeBC.run(speed);
+}) 
+sensors.touch2.onEvent(ButtonEvent.Pressed, function () {
+    if (speed > -100)
+        speed = speed - 10;
+    motors.largeBC.run(speed);
+}) 
+```
+
+## Activity 3
+
+Refactor your code by moving the speed increase and speed decrease code into ``||functions:accelerate||`` and ``||functions:decelerate||`` functions. Run the motors at the new speed in an ``||functions:update||`` function.
+
+```blocks
+let speed = 0
+function decelerate() {
+    if (speed > -100) {
+        speed = speed - 10
+    }
+}
+function accelerate() {
+    if (speed < 100) {
+        speed = speed + 10
+    }
+}
+function update() {
+    brick.clearScreen()
+    brick.showString("speed: " + speed, 1)
+    motors.largeBC.run(speed)
+}
+sensors.touch2.onEvent(ButtonEvent.Pressed, function () {
+    accelerate()
+    update()
+})
+sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
+    decelerate()
+    update()
+})
+```

docs/coding/ignition-1.md

@@ -1,11 +0,0 @@
-# Ignition Activity 1
-
-```blocks
-sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
-    brick.showImage(images.eyesDizzy)
-})
-sensors.ultrasonic4.onEvent(UltrasonicSensorEvent.ObjectDetected, function () {
-    brick.showImage(images.eyesTiredMiddle)
-})
-brick.showImage(images.eyesSleeping)
-```

docs/coding/ignition-2.md

@@ -1,12 +0,0 @@
-# Ignition Activity 2
-
-```blocks
-while (true) {
-    if (sensors.touch1.wasPressed() &&
-        sensors.ultrasonic4.distance() < 10) {
-        music.playSoundEffectUntilDone(sounds.mechanicalMotorStart)
-        music.playSoundEffectUntilDone(sounds.mechanicalMotorIdle);
-    }
-    pause(1);
-}
-```

docs/coding/ignition-3.md

@@ -1,13 +0,0 @@
-# Ignition Activity 3
-
-```blocks
-while (true) {
-    if (sensors.ultrasonic4.distance() < 10 &&
-        sensors.touch1.wasPressed() &&
-        brick.buttonEnter.wasPressed()) {
-        music.playSoundEffectUntilDone(sounds.mechanicalMotorStart)
-        music.playSoundEffectUntilDone(sounds.mechanicalMotorIdle);
-    }
-    pause(1);
-}
-```

docs/coding/ignition.md

@@ -0,0 +1,48 @@
+# Ignition
+
+Explore sensor events and sensor status.
+
+## Activity 1
+
+Wait for a touch sensor press or ultrasonic object detection. Show an expression on the screen when they happen.
+
+```blocks
+sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
+    brick.showImage(images.eyesDizzy)
+})
+sensors.ultrasonic4.onEvent(UltrasonicSensorEvent.ObjectDetected, function () {
+    brick.showImage(images.eyesTiredMiddle)
+})
+brick.showImage(images.eyesSleeping)
+```
+
+## Activity 2
+
+Play some motor sounds if touch sensor `1` is pressed at the same moment when and object comes close.
+
+```blocks
+while (true) {
+    if (sensors.touch1.isPressed() &&
+        sensors.ultrasonic4.distance() < 10) {
+        music.playSoundEffectUntilDone(sounds.mechanicalMotorStart)
+        music.playSoundEffectUntilDone(sounds.mechanicalMotorIdle);
+    }
+    pause(1);
+}
+```
+
+## Activity 3
+
+Play some motor sounds if touch sensor `1` is pressed when both the `enter` button is pressed on the brick and an object comes close.
+
+```blocks
+while (true) {
+    if (sensors.ultrasonic4.distance() < 10 &&
+        sensors.touch1.isPressed() &&
+        brick.buttonEnter.isPressed()) {
+        music.playSoundEffectUntilDone(sounds.mechanicalMotorStart)
+        music.playSoundEffectUntilDone(sounds.mechanicalMotorIdle);
+    }
+    pause(1);
+}
+```

docs/coding/light-the-way-1.md

@@ -1,7 +1,7 @@
 # Light the way Activity 1
 
 ```blocks
-sensors.color3.onLightChanged(LightIntensityMode.Ambient, LightCondition.Dark, function () {
+sensors.color3.onLightDetected(LightIntensityMode.Ambient, Light.Dark, function () {
     brick.showImage(images.objectsLightOn)
     pause(5000)
     brick.clearScreen()

docs/coding/light-the-way-2.md

@@ -1,10 +1,10 @@
 # Light the way Activity 2
 
 ```blocks
-sensors.color3.onLightChanged(LightIntensityMode.Ambient, LightCondition.Bright, function () {
+sensors.color3.onLightDetected(LightIntensityMode.Ambient, Light.Bright, function () {
     brick.clearScreen()
 })
-sensors.color3.onLightChanged(LightIntensityMode.Ambient, LightCondition.Dark, function () {
+sensors.color3.onLightDetected(LightIntensityMode.Ambient, Light.Dark, function () {
     brick.showImage(images.objectsLightOn)
 })
 ```

docs/coding/light-the-way-3.md

@@ -1,10 +1,10 @@
 # Light the way Activity 3
 
 ```blocks
-sensors.color3.onLightChanged(LightIntensityMode.Ambient, LightCondition.Bright, function () {
+sensors.color3.onLightDetected(LightIntensityMode.Ambient, Light.Bright, function () {
     brick.clearScreen()
 })
-sensors.color3.onLightChanged(LightIntensityMode.Ambient, LightCondition.Dark, function () {
+sensors.color3.onLightDetected(LightIntensityMode.Ambient, Light.Dark, function () {
     brick.showImage(images.objectsLightOn)
 })
 sensors.touch1.onEvent(ButtonEvent.Pressed, function () {

docs/coding/line-detection.md

@@ -0,0 +1,241 @@
+# Line Detection
+
+Design ways to improve driving safety by helping to prevent drivers from falling asleep and causing an accident.
+
+![Car following the line on the road](/static/coding/line-detection/car-road-line.jpg)
+
+## Connect
+
+Think about:
+
+* How can autonomous cars react to different traffic light signals?
+* What can happen if a driver falls asleep while driving?
+* How can we detect when a driver is falling asleep?
+
+## Construct
+
+### Build
+
+Build a @boardname@ vehicle that can help prevent drivers from falling asleep and causing an accident. Start by constructing this model:
+
+[![EV3 robot with color sensor](/static/coding/line-detection/ev3-robot-color-sensor-down.jpg)](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-rem-color-sensor-down-driving-base-d30ed30610c3d6647d56e17bc64cf6e2.pdf)
+
+Build red and green “lights” for your robot to detect. You can use LEGO bricks, colored tape, or marker on white paper. Building instructions:
+
+[![IMAGE: Color Squares](/static/coding/line-detection/ev3-color-squares.jpg)](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/color%20squares-0a88dfd98bb2e64b5b8151fc422bae36.pdf)
+
+### ~hint
+
+If clicking the above images doesn't open the instructions, right-click on the image and choose "Save link as..." to download the PDF.
+
+### ~
+
+### Check
+
+Before you program, check:
+
+* Are all the wires correctly connected from the motors to ports B and C?
+* Are the wheels correctly installed?
+* Are the wheels rotating freely?
+* Are the wires connected from the Color Sensor to port 3?
+
+![EV3 Driving Base](/static/coding/line-detection/ev3-robot-driving-base.jpg)
+
+### Program
+
+Autonomous cars need to recognize and respond to traffic lights automatically. Create a program that will make your robot stop at red lights. Make sure your robot is only responding to the color red. Once you have succeeded, program your robot to drive forward again when the light changes from red to green.
+
+Before you program, think about:
+
+* How will you program the robot to detect a color?
+* How will you program the robot to stop at a color?
+* Which programming blocks will you use?
+
+### ~ hint
+
+Consider using these blocks in your solution:
+
+```block
+loops.forever(function () {
+
+})
+motors.largeBC.steer(0, 50)
+sensors.color3.pauseUntilColorDetected(ColorSensorColor.Red)
+motors.stopAll()
+```
+
+### ~
+
+### Sample Solution - Red light detection
+
+1. Loop forever.
+2. Start motors ``B`` and ``C`` (drive forward).
+3. Wait for the color sensor to detect the color red.
+4. Stop all motors.
+
+```blocks
+loops.forever(function () {
+    motors.largeBC.steer(0, 50)
+    sensors.color3.pauseUntilColorDetected(ColorSensorColor.Red)
+    motors.stopAll()
+})
+```
+
+### Download and test
+
+Click **Download** and follow the instructions to get your code onto your EV3 Brick.
+
+Congratulations! Your robot can stop at a red light.
+
+Now add to your program and have your robot to drive forward again when the light changes from red to green.
+
+### Sample Solution - Red and green light detection in a loop
+
+1. Start motors ``B`` and ``C`` (drive forward).
+2. Wait for the color sensor to detect the color red.
+3. Stop all motors.
+4. Wait for the color sensor to detect the color green.
+5. Loop forever.
+
+```blocks
+loops.forever(function () {
+    motors.largeBC.steer(0, 50)
+    sensors.color3.pauseUntilColorDetected(ColorSensorColor.Red)
+    motors.stopAll()
+    sensors.color3.pauseUntilColorDetected(ColorSensorColor.Green)
+})
+```
+
+### Download and test
+
+Click **Download** and follow the instructions to get your code onto your EV3 Brick.
+
+## Contemplate
+
+To simulate what could happen if a driver falls asleep while driving, your robot could sound an alarm signal when it crosses the line. This feature is often available in new cars.
+
+Program your robot to perform this function.
+
+Draw a dark line with tape or marker for your robot to cross.
+
+### ~hint
+
+Consider using these blocks in your solution:
+
+```block
+motors.largeBC.steer(0, 50)
+music.playSoundEffect(sounds.systemGeneralAlert)
+```
+### ~
+
+### Sample Solution - Line detection in a loop
+
+1. Start motors ``B`` and ``C`` (drive forward with a curve toward the line).
+2. Wait for the color sensor to detect the color black.
+3. Play sound effect ``system general alert``.
+4. Start motors ``B`` and ``C`` (drive forward with a curve away from the line).
+5. Wait for the color sensor to detect the color white.
+6. Loop forever.
+
+```blocks
+loops.forever(function () {
+    motors.largeBC.steer(-30, 20)
+    sensors.color3.pauseUntilColorDetected(ColorSensorColor.Black)
+    music.playSoundEffect(sounds.systemGeneralAlert)
+    motors.largeBC.steer(30, 20)
+    sensors.color3.pauseUntilColorDetected(ColorSensorColor.White)
+})
+```
+
+#### Download and test
+
+Click **Download** and follow the instructions to get your code onto your EV3 Brick.
+
+#### Differentiation
+
+Program your robot to drive on “autopilot” along a given route. You will need to create a program that recognizes and responds to a dark line (or white line). You will create a line-following program and your robot will need to travel along the line without losing contact with it.
+
+You will need to constantly debug your program in order to make your robot travel as smoothly as possible along the line.
+
+### ~hint
+
+Consider using these blocks in your solution:
+
+```block
+while (true) {
+
+}
+motors.largeBC.steer(0, 50)
+```
+
+> **- OR -**
+
+```block
+if (true) {
+
+} else {
+
+}
+```
+
+### ~
+
+### Sample Solutions - Line Following in Loop
+
+#### Method 1
+
+1. While the Color Sensor detects the color black, start motors ``B`` and ``C`` (drive forward with a curve toward the line).
+2. While the Color Sensor detects the color white, start motors ``B`` and ``C`` (drive forward with a curve away from the line).
+3. Loop forever.
+
+```blocks
+forever(function () {
+    while (sensors.color3.color() == ColorSensorColor.Black) {
+        motors.largeBC.steer(-30, 50)
+    }
+    while (sensors.color3.color() == ColorSensorColor.White) {
+        motors.largeBC.steer(30, 50)
+    }
+})
+```
+
+#### Method 2
+
+1. If the Color Sensor detects the color black, start motors ``B`` and ``C`` (drive forward with a curve toward the line).
+Else the Color Sensor detects the color white, start motors ``B`` and ``C`` (drive forward with a curve away from the line).
+2. Loop forever.
+
+```blocks
+forever(function () {
+    if (sensors.color3.color() == ColorSensorColor.Black) {
+        motors.largeBC.steer(-30, 50)
+    } else {
+        motors.largeBC.steer(30, 50)
+    }
+})
+```
+
+### Download and test
+
+Click **Download** and follow the instructions to get your code onto your EV3 Brick.
+
+### Share
+
+Think about:
+
+* What challenged you?
+* Were there any surprises?
+* How can you improve your program?
+* Can your program be more streamlined? Have you used too many blocks?
+* Is there a more efficient way to build your program?
+* How can your program be used in real-world scenarios?
+
+Personalize:
+
+* Click on the **JavaScript** tab and experiment with changing the values in the code.
+* Add a custom image or sounds from the ``||brick:Brick||`` or ``||music:Music||`` menus.
+* Create a video of your project, especially your final presentation and your robot’s performance. Explain some important features of your software program.
+* Include an image of your program with comments.
+* Add a team photograph!
+
+Congratulations! What will you design next?

docs/coding/object-detection.md

@@ -0,0 +1,143 @@
+# Object Detection
+
+Design ways to avoid accidents between vehicles and objects in the road.
+
+![Deer in the road](/static/coding/object-detection/road-deer.jpg)
+
+## Connect
+
+Think about:
+
+* In what driving situations can a car hit an obstacle?
+* What do you need to be aware of to avoid collisions with obstacles?
+* What causes traffic jams in high density areas?
+
+## Construct
+
+### Build
+
+Build a @boardname@ vehicle that can avoid accidents between vehicles and objects in the road. Start by constructing this model:
+
+[![EV3 Robot Driving Base](/static/coding/object-detection/ev3-robot-driving-base.jpg)](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-ultrasonic-sensor-driving-base-61ffdfa461aee2470b8ddbeab16e2070.pdf)
+
+Build an obstacle for your robot to detect. You can build the **cuboid model** out of LEGO bricks or an obstacle of your choice.
+
+[![Cubiod block](/static/coding/object-detection/ev3-cuboid.jpg)](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-cuboid-dc93b2e60bed2981e76b3bac9ea04558.pdf)
+
+### ~hint
+
+If clicking the above images doesn't open the instructions, right-click on the image and choose "Save link as..." to download the PDF.
+
+### ~
+
+### Check
+
+Before you program, check:
+
+* Are all the wires correctly connected from the motors to ports B and C?
+* Are the wheels correctly installed?
+* Are the wheels rotating freely?
+* Are the wires connected from the Ultrasonic Sensor to port 4?
+
+### Program
+
+* Program your robot to detect any obstacles that might appear while the robot is moving forward (or backward).
+* Make the robot stop when it detects an object that is less than 20 cm away.
+
+Before you program, think about:
+* How will you program the robot to detect obstacles?
+* How will you program the robot to stop at obstacles?
+* Which programming blocks will you use?
+
+### ~hint
+
+Consider using these blocks in your solution:
+
+```block
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+
+})
+motors.largeBC.steer(0, 50)
+pauseUntil(() => true)
+let near = sensors.ultrasonic4.distance() < 20
+motors.stopAll()
+```
+
+### ~
+
+### Sample Solution
+
+1. Start the program when EV3 ``enter`` button is pressed.
+2. Turn motors ``B`` and ``C`` on at speed ``50``.
+3. Wait until Ultrasonic Sensor detects an obstacle at a distance of less than ``20`` cm.
+4. Stops all motors.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeBC.steer(0, 50)
+    pauseUntil(() => sensors.ultrasonic4.distance() < 20)
+    motors.stopAll()
+})
+```
+
+### Download and test
+
+Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the ``center`` button on the EV3 Brick to run the program.
+
+## Contemplate
+
+On the road, when a driver sees and object, they slow their car down before coming to a full stop.
+
+Program your EV3 Driving Base to do the same.
+
+If the Ultrasonic Sensor:
+
+* Detects an object less than `10` cm away, make the robot stop.
+* Detects an object between `10` and `20` cm away, make the robot slow down.
+* Does not detect any object, continue to move at full speed.
+
+### ~hint
+
+Consider using this block in your solution:
+
+```block
+if (true) {
+}
+```
+
+### ~
+
+### Sample Solution
+
+```blocks
+loops.forever(function () {
+    motors.largeBC.steer(0, 50)
+    if (sensors.ultrasonic4.distance() < 10) {
+        motors.stopAll()
+    } else if (sensors.ultrasonic4.distance() < 20) {
+        motors.largeBC.steer(0, 10)
+    }
+})
+```
+
+### Download and test
+
+Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the ``center`` button on the EV3 Brick to run the program.
+
+## Continue
+
+* Get together with other building teams and make a traffic jam by placing all of your robots in a line with varying amounts of space between them.
+* Have everyone start their robots at the same time and see what happens.
+* Refine your programs so that all of the robots continue driving at the same speed with equal distances between them.
+* Click on the JavaScript tab and experiment with changing the values in the code.
+* Add a custom image or sounds from the Brick or Music menus.
+
+### Share
+
+* Share what you think “efficiency in programming” means.
+* Explore the different solutions other programmers came up with.
+* Create a video of your project, especially your final presentation and your robot’s performance. Explain some important features of your software program.
+* Include an image of your program with comments.
+* Add a team photograph!
+
+Congratulations! What will you design next?

docs/coding/traffic-lights-1.md

@@ -3,7 +3,7 @@
 ```blocks
 brick.buttonEnter.onEvent(ButtonEvent.Bumped, function () {
     motors.largeBC.tank(20, 20)
-    sensors.color3.pauseForColor(ColorSensorColor.Red)
+    sensors.color3.pauseUntilColorDetected(ColorSensorColor.Red)
     motors.largeBC.tank(0, 0)
 })
 ```

docs/design-engineering.md

@@ -6,22 +6,22 @@
 [
     {
         "name": "Make It Move Without Wheels",
-        "description": "TBD",
-        "imageUrl": "/static/lessons/make-it-move.png",
+        "description": "Design, build and program a robot that can move itself using no wheels for locomotion.",
+        "imageUrl": "/static/lessons/make-it-move-without-wheels.png",
         "url": "/design-engineering/make-it-move",
         "cardType": "side"
     },
     {
         "name": "Make It Smarter and Faster",
-        "description": "TBD",
-        "imageUrl": "/static/lessons/make-it-smarter.png",
+        "description": "Design, build and program a robotic creature that can sense its environment and respond by moving.",
+        "imageUrl": "/static/lessons/make-it-smarter-and-faster.png",
         "url": "/design-engineering/make-it-smarter",
         "cardType": "side"
     },
     {
         "name": "Make a System that Communicates",
-        "description": "A robot that tells you what it is doing.",
-        "imageUrl": "/static/lessons/make-it-communicate.png",
+        "description": "Design, build and program a robotic system that follows a path and communicates its position at least twice along the way.",
+        "imageUrl": "/static/lessons/make-a-system-that-communicates.png",
         "url": "/design-engineering/make-it-communicate",
         "cardType": "side"
     }

docs/design-engineering/make-it-communicate.md

@@ -1,6 +1,6 @@
 # Make A System That Communicates
 
-## Connect 
+## Connect
 
 ### Design Brief
 
@@ -8,9 +8,9 @@ Design, build and program a robotic system that follows a path and communicates
 
 https://www.youtube.com/watch?v=6piMI1JPDQc
 
-*	Robotic systems are built from smaller, related subsystems. Look at the automobile system shown in the video. What subsystems can you see?
-*	What kinds of robots follow a path?
-*	What kind of system do you want to make?
+* Robotic systems are built from smaller, related subsystems. Look at the automobile system shown in the video. What subsystems can you see?
+* What kinds of robots follow a path?
+* What kind of system do you want to make?
 
 ### Brainstorm
 
@@ -20,56 +20,77 @@ Think about:
 * What kind of motorized mechanism can be used to control the movements of a robot?
 * How can the robot sense where it is along the path?
 * How can the robot communicate its position?
- 
- ![EV3 + LEGO Bricks](/static/lessons/make-it-communicate/hero.png)
 
-## Construct 
+![EV3 + LEGO Bricks](/static/lessons/make-it-communicate/ev3-plus-parts.jpg)
+
+## Construct
 
 ### Build
 
 You can start by tinkering with the LEGO elements in the picture and then build on.
 
-More building ideas: 
-* [EV3 Frames](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/ev3%20frames-5054ee378e624fb4cb31158d2fc8e5cf.pdf)
+More building ideas:
 
-* [Tracks](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/tracks-32d7554813af3f25cf5012d54a4bad2b.pdf)
+[![EV3 Frames](/static/lessons/make-it-communicate/ev3-frames.jpg)](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/ev3%20frames-5054ee378e624fb4cb31158d2fc8e5cf.pdf)
 
-* [Color Sensor 2](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/color%20sensor_v2-e7fd54b6fa3cdfe36f414c1d2510f9cb.pdf)
+[![Tracks](/static/lessons/make-it-communicate/ev3-tracks.jpg)](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/tracks-32d7554813af3f25cf5012d54a4bad2b.pdf)
+
+[![Color Sensor 2](/static/lessons/make-it-communicate/ev3-color-sensor2.jpg)](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/color%20sensor_v2-e7fd54b6fa3cdfe36f414c1d2510f9cb.pdf)
+
+### ~hint
+
+If clicking the above images doesn't open the instructions, right-click on the image and choose "Save link as..." to download the PDF.
+
+### ~
 
 
-Build a path for your robot to follow. You can use electrical tape on a floor, or marker on paper. You can use objects as milestones to indicate a path that can be detected by either the Touch Sensor, Color Sensor, or Ultrasonic Sensor. 
+Build a path for your robot to follow. You can use electrical tape on a floor, or marker on paper. You can use objects as milestones to indicate a path that can be detected by either the Touch Sensor, Color Sensor, or Ultrasonic Sensor.
 
-## Program 
+### Program
 
-Before you program, think about: 
- 
-*	How will you program the robot to follow a path?
-*	How will you program the robot to communicate its position?
-*	Which programming blocks will you use?
+Before you program, think about:
 
-### ~ hint
+* How will you program the robot to follow a path?
+* How will you program the robot to communicate its position?
+* Which programming blocks will you use?
+
+### ~hint
 
 Explore the different Motor and Sensor blocks in the programming menu.
 
 ### ~
 
-### Sample Solution 
+### Sample Solution
 
-[Video: EV3 Track Rover](/static/lessons/make-it-communicate/trackrover.mp4)
+[![Video: EV3 Track Rover](/static/lessons/make-it-communicate/ev3-track-rover.jpg)](https://legoeducation.23video.com/v.ihtml/player.html?token=79c99735f906403a4dd7f2909935983d&source=embed&photo%5fid=19857954)
 
 The Track Rover follows a path using the color sensor. It identifies two locations by color.
 
-[Building Instructions](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/ev3-dep/building%20instructions/track-rover-bi-6aadb1b053df0c58a0dea108b5ce0eea.pdf)
+Track Rover solution combines these building ideas:
 
-### Sample Program Solution 
+* EV3 frames
+* Tracks
+* Color sensor 2
 
-This program works with the Track Rover. If you create a different robot, adjust the program to fit your solution. 
+Two copies of the tracks are built: one for the right side and a mirror image for the left side.
 
-#### Program summary: 
+[![Track rover assembled](/static/lessons/make-it-communicate/ev3-track-rover2.jpg)](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/ev3-dep/building%20instructions/track-rover-bi-6aadb1b053df0c58a0dea108b5ce0eea.pdf)
+
+### ~hint
+
+If clicking the above image doesn't open the instructions, right-click on the image and choose "Save link as..." to download the PDF.
+
+### ~
+
+### Sample Program Solution
+
+This program works with the Track Rover. If you create a different robot, adjust the program to fit your solution.
+
+Program summary:
 
 * If the Color Sensor sees black, Motor B runs at -50 power and Motor C turns off.
 * If the Color Sensor sees white, Motor B turns off and Motor C runs at -50 power.
-* If the Color Sensor sees green, all motors stop and the green sound plays. 
+* If the Color Sensor sees green, all motors stop and the green sound plays.
 * The robot waits one second, then motors move forward.
 * If the Color Sensor sees red, all motors stop, and the red sound plays.
 * The robot waits one second, then motors move forward.
@@ -91,74 +112,52 @@ forever(function () {
         motors.stopAll()
         music.playSoundEffectUntilDone(sounds.colorsRed)
         motors.largeBC.run(-50)
-    } else {
-
     }
 })
 ```
 
-```blocks
-sensors.color3.onColorDetected(ColorSensorColor.Black, function () {
-    motors.largeB.run(-50)
-    motors.largeC.run(0)    
-})
-sensors.color3.onColorDetected(ColorSensorColor.White, function () {
-    motors.largeB.run(0)    
-    motors.largeC.run(-50)
-})
-sensors.color3.onColorDetected(ColorSensorColor.Green, function () {
-    motors.stopAll()
-    music.playSoundEffect(sounds.colorsGreen)
-    pause(1000)  
-    motors.largeBC.run(-50)
-})
-sensors.color3.onColorDetected(ColorSensorColor.Red, function () {
-    motors.stopAll()
-    music.playSoundEffect(sounds.colorsRed)
-    pause(1000)
-    motors.largeBC.run(-50)
-})
-```
-
 ### Download and test
 
 Click Download and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
 
-## Contemplate 
+## Contemplate
 
-### Test and Analyze 
+### Test and Analyze
 
-As you work on your solution: 
-1. Describe one part of your design that worked especially well. 
-2. Describe one design change that you had to make. 
-3. What will you try next? 
+As you work on your solution:
+
+1. Describe one part of your design that worked especially well.
+2. Describe one design change that you had to make.
+3. What will you try next?
 
 
-### Review and Revise 
-Take a moment to reflect on your robot solution. 
+### Review and Revise
 
-### Think about: 
-*	Can the robot’s movement be more accurate? 
-*	What are some ways that others have solved the problem?
+Take a moment to reflect on your robot solution.
+
+Think about:
+
+* Can the robot’s movement be more accurate?
+* What are some ways that others have solved the problem?
 
 Describe two ways you could improve your robot.
 
-## Continue 
+## Continue
 
 ### Personalize your project
-*	Add/remove LEGO elements to improve the way your robot moves. 
-*	Click on the JavaScript tab and experiment with changing the values in the code.
-*	Add a custom image or sounds by adding blocks from the Brick or Music menus.
 
-## Communicate 
+* Add/remove LEGO elements to improve the way your robot moves.
+* Click on the JavaScript tab and experiment with changing the values in the code.
+* Add a custom image or sounds by adding blocks from the Brick or Music menus.
 
-Here are some ideas: 
-*	Create a video of your project, especially your final presentation and your robot’s performance. 
-*	Explain some important features of your software program. 
-*	Produce a building guide for your model by taking a series of photographs as you deconstruct it. 
-*	Include an image of your program with comments. 
-*	Add a team photograph! 
+## Communicate
+
+Here are some ideas:
+
+* Create a video of your project, especially your final presentation and your robot’s performance.
+* Explain some important features of your software program.
+* Produce a building guide for your model by taking a series of photographs as you deconstruct it.
+* Include an image of your program with comments.
+* Add a team photograph!
 
 Congratulations! What will you design next?
-
-

docs/design-engineering/make-it-move.md

@@ -1,90 +1,105 @@
 # Make It Move Without Wheels
 
-## ~ avatar
-
-Design, build and program a robot that can move itself using no wheels for locomotion.
-
-## ~
-
 ## Connect
 
 ### Design Brief
 
-Design, build and program a robot that can move itself a distance of at least 30cm, using at least one motor, using NO wheels for locomotion.
+Design, build and program a robot that can move itself using no wheels for locomotion.
+
+![Make it move banner](/static/lessons/make-it-move/make-it-move-without-wheels.png)
+
+Your robot will:
+
+* Go a distance of at least 30cm
+* Use at least one motor
+* Use NO wheels for locomotion
 
 ### Brainstorm
 
-Discuss different solutions to the design brief.
-
-Think about:
-
-How can robots move without wheels? For example, how will you:
-* Connect the motor(s) to something to make the robot walk, crawl, or wiggle?
-How will you program the robot to move? For example, which programming blocks will you use to:
-* Turn on and turn off the motor or motors?
-* Display the distance moved?
-
-### Select the Best Solution
-
-Describe the solution that you have agreed to build and program.
-
-Think about examples from your brainstorming discussion. Then explain why you chose this solution for the design brief.
-
-![The Mars rover](/static/lessons/make-it-move/hero.png)
-
-https://www.youtube.com/ErC_s3hLGMk
+In nature, creatures use many methods to get around. None of them, however, use wheels to move. Can we copy the method of animal locomotion with our robot? Using motors and legs, make a robot that can move without using any wheels.
 
 ## Construct
 
-### Build and Program
+### Build
 
-Now you are ready to start building and programming your solution!
+Think about a creature’s movement for inspiration. Will you make the robot walk, crawl, hop, or wiggle?  Your mechanism can be attached or unattached to the EV3 Brick. You can start by tinkering with the LEGO elements in the picture above and then build on.
+
+### Building Hint
+
+If you want some building help you can follow these instructions.
+
+[![Toddle Bot](/static/lessons/make-it-move/toddle-bot.jpg)](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/toddle%20bot-3dcad146d7f5deac4753f93e9dcc0739.pdf)
+
+Click [here](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/toddle%20bot-3dcad146d7f5deac4753f93e9dcc0739.pdf)
+
+### ~hint
+
+If clicking the above image or link doesn't open the instructions, right-click on the link and choose "Save link as..." to download the PDF.
+
+### ~
+
+### Program
+
+Before you program, think about:
+
+* How will you program the robot to move?
+* How will you program the robot to stop?
+* How will you program the robot to display the distance moved?
+
+Which programming blocks will you use:
+
+* To turn on and turn off the motor or motors?
+* To display the distance moved?
+
+### Sample Code
+
+Example code of a robot that moves without wheels using one motor:
+
+* The robot moves with ``large motor D`` rotating at ``-100`` speed
+* The robot moves for ``30000`` milliseconds (30 seconds)
+* The robot stops
+* The robot displays the text ``"30cm"``
 
 ```blocks
-motors.largeBC.tank(-60, 60, 9, MoveUnit.Rotations);
-motors.stopAll();
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeD.run(-100)
+    loops.pause(30000)
+    motors.stopAll()
+    brick.showString("30cm", 1)
+})
 ```
 
-As you work on your solution:
+### Download and test
 
-* Describe one part of your design that worked especially well.
-* Describe one design change that you had to make.
-
-What will you try next?
-	
-As you test your design solution, use the table for recording your findings.
-
-[**VIEW BUILDING INSTRUCTIONS**](TODO) for a sample solution. (7.8 MB, PDF)
+Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
 
 ## Contemplate
 
 ### Test and Analyze
 
-How well does your solution satisfy the design brief? Record your data. Name the columns and rows, such as Trial Number, Distance Moved, and Observations.
-
-### Review and Revise
-
-Take a moment to reflect on your robot solution.
-
 Think about:
+
 * Is the robot using something other than wheels to move? Trace the movement from the motor axle to the mechanism(s) that drives the robot forward, backward or sideways. Wheels can be used to stabilize the robot but not to drive it.
-* Does the robot display the distance moved?
-* Is it accurate? How do you know?
-Describe two ways you could improve your robot.
+* Does the robot display the distance moved? Is it accurate? How do you know?
+* What is one part of your design that worked well?
+* What is a change that you need to make?
+* What will you try next?
 
 ## Continue
 
-### Communicate
+### Personalize your project
+
+* Add/remove LEGO elements to improve the way your robot moves. Will your robot walk, wiggle, hop, or slither? Will it move slower, faster or farther?
+* Click on the JavaScript tab and experiment with changing the values in the code.
+* Add a custom image or sounds by adding blocks from the Brick or Music menus.
+* Does your robot resemble a creature? Add arts and crafts materials to your project.
+
+## Communicate
 
-Here are some ideas:
 * Create a video of your project, especially your final presentation and your robot’s performance.
 * Explain some important features of your software program.
 * Produce a building guide for your model by taking a series of photographs as you deconstruct it.
 * Include an image of your program with comments.
 * Add a team photograph!
 
-## ~ avatar
-
 Congratulations! What will you design next?
-
-## ~

docs/design-engineering/make-it-smarter.md

@@ -1,7 +1,6 @@
-# Make It Smarter and Faster 
+# Make It Smarter and Faster
 
-
-## Connect 
+## Connect
 
 ### Design Brief
 
@@ -11,125 +10,103 @@ https://www.youtube.com/watch?v=y9-A_C_08KY
 
 * What do the robots in the video need to be able to sense, plan, and act?
 * What senses do humans have and why are they important to us?
-* How many human-like senses do you see the robots demonstrating? 
+* How many human-like senses do you see the robots demonstrating?
 
-### Brainstorm 
+### Brainstorm
 
 Discuss different solutions to the design brief.
 
-Think about: 
+Think about:
 
-* What kind of creature can it be? 
-* How can it move? 
-* What does it need to be aware so that it stays safe, well fed and warm (or cool)? 
-* Is it looking for food, a safe place to hide or a warm place to soak up the sun? 
-* Will the creature need to move fast or slow? 
-* Will it need to turn? 
+* What kind of creature can it be?
+* How can it move?
+* What does it need to be aware so that it stays safe, well fed and warm (or cool)?
+* Is it looking for food, a safe place to hide or a warm place to soak up the sun?
+* Will the creature need to move fast or slow?
+* Will it need to turn?
 * Will it need to go backward?
 
 ![EV3 and bricks](/static/lessons/make-it-smarter/bricks.png)
 
 ## Construct
- 
+
 ### Build
 
-Think about a creature’s movement for inspiration. Your mechanism can be attached or unattached to the EV3 brick. You can start by tinkering with the LEGO elements in the picture add then build on.
-More building ideas: 
+Think about a creature’s movement for inspiration. Your mechanism can be attached or unattached to the EV3 Brick. You can start by tinkering with the LEGO elements in the picture add then build on.
 
-* [EV3 Frames](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/ev3%20frames-5054ee378e624fb4cb31158d2fc8e5cf.pdf)
-* [Color Sensor 1](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/color%20sensor_v1-16a7231bdc187cd88a8da120c68f58d5.pdf)
-* [Gyro Sensor](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/gyro%20sensor-6f0fdbd82ae45fe0effa0ebf3f460f3d.pdf)
-* [Ultrasonic Sensor](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/ultrasonic%20sensor-a56156c72e8946ed4c58c5e69f3520d3.pdf)
-* [Touch Sensor](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/touch%20sensor-868fda1b9d6070a0a034fb22456a7fc9.pdf)
-* [Jaw](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/jaw-ee93e8f3243e4d30cd34b0c337c33653.pdf)
-* [Leg 1](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/leg%201-c14624046ea3a95148820ed404f5ac65.pdf)
-* [Leg 2](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/leg%202-8855c35b990205f6b9d7130687a3d4db.pdf)
-* [Leg 3](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/leg%203-575d52ef15fb79f1e4d3350d36607160.pdf)
+More building ideas:
 
 
-### Program 
+* [EV3 Frames]
+* [Color Sensor 1]
+* [Gyro Sensor]
+* [Ultrasonic Sensor]
+* [Touch Sensor]
+* [Jaw]
+* [Leg 1] 
+* [Leg 2]
+* [Leg 3]
 
-Before you program, think about:  
+### ~hint
+
+If clicking the above links doesn't open the instructions, right-click on the image and choose "Save link as..." to download the PDF.
+
+### ~
+
+### Program
+
+Before you program, think about:
 
 * How will you program the robot to sense?
 * How will you program the robot to respond?
 * Which programming blocks will you use?
 
-### ~ hint
+### ~hint
 
 **Hint:** Explore the different Sensor blocks in the Sensors Menu
 
 ### ~
 
-## SCREEN 5
+### Sample Solution
 
-Sample Solution 
-
-[Video: EV3 Insect]
-
-This Insect uses its Ultrasonic Sensor to sense danger and move away from threat.
+The Insect uses its Ultrasonic Sensor to sense danger and move away from a threat.
 
+https://www.youtube.com/watch?v=PoeYoiXHHE4
+<br/>
 The Insect solution combines these building ideas:
 
-* EV3 Frames
-* Leg 2
-* Leg 3
-* Ultrasonic Sensor 
+* [EV3 Frames]
+* [Leg 2]
+* [Leg 3]
+* [Ultrasonic Sensor]
 
-Four copies of Leg 3 were built: one for the front left, one for the back right, and two mirror copies for the front right and back left.
+Four copies of Leg 3 are built: one for the front left, one for the back right, and two mirror copies for the front right and back left.
 
-* [Building Instructions](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/insect-94b8a46f0dc5082c9d78ddb734626dc9.pdf)
+Building Instructions:
 
-### Sample Solution 
+[![Insect robot](/static/lessons/make-it-smarter/insect-bot.jpg)](https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/insect-94b8a46f0dc5082c9d78ddb734626dc9.pdf)
 
-This program checks if the Ultrasonic Sensor senses something near. 
+### ~hint
 
-This program:
+If clicking the above images or links doesn't open the instructions, right-click on the link and choose "Save link as..." to download the PDF.
 
-* Turns on the green EV3 brick Status Light
+### ~
 
-```block
-brick.setStatusLight(StatusLight.Green)
-```
+### Sample Solution
 
-* Waits for Ultrasonic Sensor to detect an object
+This program checks if the Ultrasonic Sensor senses something near.
 
-```block
-sensors.ultrasonic4.pauseUntil(UltrasonicSensorEvent.ObjectDetected)
-```
+The blocks inside the ``||loops:forever||`` loop have these actions:
 
-* Turns on Motors A and D in opposite directions
-
-```block
-motors.largeAD.tank(50, -50)
-```
-
-* Waits for one half of a second (1500 milli seconds)
-
-```block
-pause(1500)
-```
-
-* Reverses the direction of Motors A and D
-
-```block
-motors.largeAD.tank(-50, 50)
-```
-
-* Waits for one half of a second
-* Stops all motors
-
-```block
-motors.stopAll()
-```
-
-* Makes an insect chirping sound
-
-```block
-music.playSoundEffectUntilDone(sounds.animalsInsectChirp)
-```
-
-* Loops so the insect wanders around when the Ultrasonic Sensor is triggered
+1. Turn on the ``green`` EV3 Brick Status Light.
+2. Wait for Ultrasonic Sensor to detect an object.
+3. Turn on Motors ``A`` and ``D`` in opposite directions.
+4. Wait for one and a half seconds (``1500`` milli seconds).
+5. Reverse the direction of Motors ``A`` and ``D``.
+6. Wait for one and a half seconds.
+7. Stop all motors.
+8. Make an insect chirping sound.
+9. Loop continuously so that the insect wanders around when the Ultrasonic Sensor is detects something.
 
 ```blocks
 forever(function () {
@@ -146,47 +123,56 @@ forever(function () {
 
 ### Download and test
 
-Click Download and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
 
-## Contemplate 
+## Contemplate
 
-### Test and Analyze 
+### Test and Analyze
 
-As you work on your solution: 
-1. Describe one part of your design that worked especially well. 
-2. Describe one design change that you had to make. 
-3. What will you try next? 
+As you work on your solution:
+1. Describe one part of your design that worked especially well.
+2. Describe one design change that you had to make.
+3. What will you try next?
 
+### Review and Revise
 
-### Review and Revise 
+Take a moment to reflect on your robot solution.
 
-Take a moment to reflect on your robot solution. 
+Think about:
 
-Think about: 
-
-* Does your robot move when the sensor is activated? 
-* If not, what will you change to make the robot’s ability to sense and respond more obvious? 
-* What other behaviors can you add to the robot to make it more realistic? 
+* Does your robot move when the sensor is activated?
+* If not, what will you change to make the robot’s ability to sense and respond more obvious?
+* What other behaviors can you add to the robot to make it more realistic?
 
 Describe two ways you could improve your robot.
 
+## Continue
 
-## Continue 
+Personalize your project:
 
-Personalize your project
-
-* Add/remove LEGO elements to improve the way your robot moves. 
+* Add/remove LEGO elements to improve the way your robot moves.
 * Click on the JavaScript tab and experiment with changing the values in the code.
 * Add a custom image or sounds by adding blocks from the Brick or Music menus.
-* Does your robot resemble a creature? Add arts and crafts materials to you project.
+* Does your robot resemble a creature? Maybe add more craft materials to your project.
 
-## Communicate 
+## Communicate
 
-Here are some ideas: 
+Here are some ideas:
 
-* Create a video of your project, especially your final presentation and your robot’s performance. Explain some important features of your software program. 
-* Produce a building guide for your model by taking a series of photographs as you deconstruct it. 
-* Include an image of your program with comments. 
-* Add a team photograph! 
+* Create a video of your project, especially your final presentation and your robot’s performance. Explain some important features of your software program.
+* Produce a building guide for your model by taking a series of photographs as you deconstruct it.
+* Include an image of your program with comments.
+* Add a team photograph!
 
 Congratulations! What will you design next?
+
+
+[EV3 Frames]: https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/ev3%20frames-5054ee378e624fb4cb31158d2fc8e5cf.pdf
+[Color Sensor 1]: https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/color%20sensor_v1-16a7231bdc187cd88a8da120c68f58d5.pdf
+[Gyro Sensor]: https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/gyro%20sensor-6f0fdbd82ae45fe0effa0ebf3f460f3d.pdf
+[Ultrasonic Sensor]: https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/ultrasonic%20sensor-a56156c72e8946ed4c58c5e69f3520d3.pdf
+[Touch Sensor]: https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/touch%20sensor-868fda1b9d6070a0a034fb22456a7fc9.pdf
+[Jaw]: https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/jaw-ee93e8f3243e4d30cd34b0c337c33653.pdf
+[Leg 1]: https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/leg%201-c14624046ea3a95148820ed404f5ac65.pdf
+[Leg 2]: https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/leg%202-8855c35b990205f6b9d7130687a3d4db.pdf
+[Leg 3]: https://le-www-live-s.legocdn.com/sc/media/files/support/mindstorms%20ev3/building-instructions/design%20engineering%20projects/leg%203-575d52ef15fb79f1e4d3350d36607160.pdf

docs/examples.md

@@ -21,11 +21,11 @@ Here are some fun programs for your @boardname@!
   "imageUrl": "/static/maker/security-gadget.png"
 },
 {
-  "name": "Intruder Detector",
-  "description": "Raise the alarm when an intruder sneaks in",
-  "url":"/maker/intruder-detector",
+  "name": "Movement Detector",
+  "description": "Raise the alarm when an movement sneaks in",
+  "url":"/maker/movement-detector",
   "cardType": "example",
-  "imageUrl": "/static/maker/intruder-detector.png"
+  "imageUrl": "/static/maker/movement-detector.png"
 },
 {
   "name": "Puppet",
@@ -212,6 +212,12 @@ Here are some fun programs for your @boardname@!
   "description": "Keep your brick entertained and happy",
   "url":"/examples/happy-unhappy",
   "cardType": "example"
+}, {
+{
+  "name": "Turtle",
+  "description": "Encode moves and run them on a driving base",
+  "url":"/examples/turtle",
+  "cardType": "example"
 }, {
   "name": "Distance Measurer",
   "description": "Use a motor to measure angle and distance",

docs/examples/line-follower-pid.md

@@ -14,7 +14,7 @@ v = sensors.color3.light(LightIntensityMode.Reflected)
 min = v
 max = v
 setpoint = v
-while (!(brick.buttonEnter.wasPressed())) {
+while (!(brick.buttonEnter.isPressed())) {
     brick.clearScreen()
     brick.showString("Move robot on terrain", 1)
     brick.showString("Press ENTER when done", 2)

docs/examples/print-ports.md

@@ -1,40 +0,0 @@
-
-# Print Ports
-
-```typescript
-/**
- * Print the port states on the screen
- */
-//% blockId=brickPrintPorts block="print ports"
-//% help=brick/print-ports
-//% weight=1 group="Screen"
-function printPorts() {
-    const col = 44;
-    clearScreen();
-
-    function scale(x: number) {
-        if (Math.abs(x) > 1000) return Math.round(x / 100) / 10 + "k";
-        return ("" + (x >> 0));
-    }
-
-    // motors
-    const datas = motors.getAllMotorData();
-    for(let i = 0; i < datas.length; ++i) {
-        const data = datas[i];
-        if (!data.actualSpeed && !data.count) continue;
-        const x = i * col;
-        print(`${scale(data.actualSpeed)}%`, x, brick.LINE_HEIGHT)
-        print(`${scale(data.count)}>`, x, 2 * brick.LINE_HEIGHT)
-        print(`${scale(data.tachoCount)}|`, x, 3 * brick.LINE_HEIGHT)
-    }
-
-    // sensors
-    const sis = sensors.internal.getActiveSensors();
-    for(let i =0; i < sis.length; ++i) {
-        const si = sis[i];
-        const x = (si.port() - 1) * col;
-        const v = si._query();
-        print(`${scale(v)}`, x, 9 * brick.LINE_HEIGHT)
-    }
-}
-```

docs/extensions.md

@@ -0,0 +1,18 @@
+# Extensions
+
+## #gallery
+
+## Using Extensions
+
+In the web editor, click on ``Settings`` then ``Extensions`` to search and add extensions to the project.
+The Blocks and JavaScript definitions will be automatically loaded in the editor.
+
+## Custom extensions
+
+The [Build Your Own Extension](https://makecode.com/extensions/getting-started) manual is for advanced users who want to publish their own extension. 
+
+## ~ hint
+
+**Extensions** were previously called **Packages** in MakeCode.
+
+## ~

docs/fll.md

@@ -0,0 +1,116 @@
+# MakeCode for _FIRST_ LEGO League
+
+![FIRST LEGO League logo](/static/fll/fll-logo.png)
+
+**For teams participating in City Shaper challenge**, you can use MakeCode for your challenge (see [City Shaper Challenge, page 7 bottom](https://firstinspiresst01.blob.core.windows.net/fll/2020/city-shaper-game-guide-pdf.pdf)!
+
+We’ve compiled a list of resources and information that we hope will be helpful for you.
+
+* **Got a question? Post it on the forums** at https://forum.makecode.com/
+
+## FAQ
+
+### I found a bug what do I do?
+
+If you found a bug, please try if it hasn't been fixed yet! Go to https://makecode.mindstorms.com/beta and try if the bug is corrected. Otherwise, please tell us at https://forum.makecode.com/.
+
+### How do I use MakeCode with my EV3?
+
+* You will need to install the latest EV3 firmware on your brick. Instructions on how to do that are located here: https://makecode.mindstorms.com/troubleshoot.
+* You will need a computer with a USB port to connect to the EV3 in order to download your programs.
+* You will need internet access and a browser on your computer to get to https://makecode.mindstorms.com.
+* You can [install the app](/offline-app) to use the editor offline.
+
+### I know LabView, how is MakeCode different?
+
+We have compiled a guide for EV3 LabView users at https://makecode.mindstorms.com/labview.
+
+### What’s the best way to get started with MakeCode?
+
+Go to https://makecode.mindstorms.com. The home screen is filled with videos, tutorials and examples that might be relevant for your missions.
+
+On the home page, scroll down to the **FLL / City Shaper** section for specific lessons related to Mission 2.
+
+### Can I load both LEGO MINDSTORMS EV3 Software and MakeCode programs onto my EV3?
+
+Yes.
+
+### Does it work without internet?
+
+No, the editor is cached in your browser cache. However, you can also download the [offline app](/offline-app) in case you need to install it on a computer.
+
+### How do I figure out what a block does?
+
+You can right-click on any block and select “Help” in the context menu to open the documentation page describing what that block does.
+
+![Select help in context menu for block](/static/fll/context-help.jpg)
+
+### How do I program in JavaScript?
+
+Click the **JavaScript** button at the top of the page to get to the JavaScript editor. Students can drag and drop code snippets from the Toolbox on the left, or type directly in the editor. You can switch back and forth between **Blocks** and **JavaScript** as you program.
+
+![Coding in JavaScript](/static/fll/code-js.gif)
+
+Also, watch the [Text-based Coding](https://legoeducation.videomarketingplatform.co/v.ihtml/player.html?token=3513a83b87fe536b2dc512237465fd1b&source=embed&photo%5fid=35719471) video for more about coding using the JavaScript editor.
+
+### How do I use the Simulator?
+
+The Simulator will show the physical representation of your code blocks. For example, based on this code snippet, the Simulator will show the touch sensor on Port 1, and a large motor on Port D.
+
+```blocks
+sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeD.run(50)
+})
+```
+
+![Simulator demonstration](/static/fll/simulator.gif)
+
+Note that the Simulator is also interactive, so you can simulate inputs with any of the sensors.
+
+See the video [Block-based Coding and Simulation](https://legoeducation.videomarketingplatform.co/v.ihtml/player.html?token=629730c938e452f0fd7653fbc4708166&source=embed&photo%5fid=35719470) for more about using the simulator.
+
+### How do I save my programs?
+
+MakeCode will automatically save your recent projects in the browser. However, you can also save a copy of your project as a file on your computer:
+
+* From the **Settings** menu, select **Save Project**
+* This will download your program from the browser as a _lego-myproject.uf2_ file
+
+![Save project menu selection](/static/fll/save-project.jpg)
+
+* You can import your saved projects by clicking the Import button on the Home Page
+ 
+![Import button on home screen](/static/fll/import-button.jpg)
+
+### How do I share my programs?
+
+You can share your projects by clicking on the **share** button in the top left of the screen.  This will create a URL which you can send others to open and view your project.
+ 
+![Share button in editor](/static/fll/share-button.jpg)
+
+![Share button and dialogs demo](/static/fll/share-program.gif)
+
+Sharing programs is also shown in the [Tips and Tricks](https://legoeducation.videomarketingplatform.co/v.ihtml/player.html?token=5c594c2373367f7870196f519f3bfc7a&source=embed&photo%5fid=35719472) video.
+
+### Can I use Bluetooth to transfer my program?
+
+The official answer is currently no. That being said, we have **Experimental support** for Bluetooth download. Please read the [Bluetooth](/bluetooth) page for more information.
+
+https://youtu.be/VIq8-6Egtqs
+
+### Why can't I delete my program (*.uf2) files from the Brick?
+
+There's a bug in the firmware which prevents you from deleting the programs (``*.uf2`` files) from your EV3 Brick. There isn't a firmware update to fix this yet.
+
+We have prepared a special program that lets you delete UF2 files from the brick.
+Download [these PDF instructions](/file-manager.pdf) and drop the PDF on the brick drive.
+This will present you with an menu for deleting files.
+
+For other common questions, try the FAQ page https://makecode.mindstorms.com/faq.
+
+## Workarounds
+
+1. Deleting Programs from the EV3 brick
+
+>* Description: Unable to delete program files from the EV3 brick after downloading them
+>* Status: LEGO Education team is working on a fix, no estimated date yet

docs/getting-started.md

@@ -4,19 +4,33 @@
 
 ```codecard
 [
+{
+    "name": "Prepare",
+    "imageUrl": "/static/lessons/firmware.png",
+    "description": "To use Microsoft MakeCode with your EV3 Brick, you will need to install the latest LEGO® MINDSTORMS® Education EV3 firmware.",
+    "label": "New? Start Here!",
+    "labelClass": "red ribbon large",
+    "url": "https://makecode.mindstorms.com/troubleshoot"
+},
 {
     "name": "Try",
     "imageUrl": "/static/lessons/try.png",
-    "description": "TBD",
+    "description": "Get a quick introduction to programming.",
     "url": "/getting-started/try",
     "cardType": "side"
 },
 {
-    "name": "use",
+    "name": "Use",
     "imageUrl": "/static/lessons/use.png",
-    "description": "TBD",
+    "description": "Build a robot and drive into the world of robotics!",
     "url": "/getting-started/use",
     "cardType": "side"
+},
+{
+    "name": "First LEGO League",
+    "imageUrl": "/static/fll/fll-big.png",
+    "description": "Information about using MakeCode in FLL competitions",
+    "url": "/fll"
 }
 ]
 ```

docs/getting-started/try-tutorial.md

@@ -0,0 +1,194 @@
+# Try
+
+## Introduction @unplugged
+
+Get a quick introduction to programming with EV3.
+
+![Display on EV3 Brick with Music Notes](/static/getting-started/01_EyesOn_Intro.png)
+
+We are excited to help you get started with @boardname@. In this project we will guide you through connecting your EV3 Brick, creating your first program, controlling a Large Motor, a Touch Sensor and a Color Sensor. These steps can take up to 45 minutes.
+
+## Turn on your EV3 Brick @unplugged
+
+Power on your EV3 Brick by pressing the Center Button.
+
+![Hand pressing power button](/static/getting-started/02_PowerOn.png)
+
+## Connect Your EV3 Brick to Your Device @unplugged
+
+Use the USB cable to connect your EV3 Brick to your device.
+
+![Computer and cable connected to EV3 Brick](/static/getting-started/03_insert-usb-02.png)
+
+## Handle a button press @fullscreen
+
+Drag out a ``||brick:on button||`` block from Buttons section in the ``||brick:Brick||`` Toolbox drawer.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+})
+```
+
+## Change of mood @fullscreen
+
+Drag a Brick Screen ``||brick:show mood||`` block inside the ``||brick:on button||`` block.
+Change mood to ``neutral``.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    brick.showMood(moods.neutral)
+})
+```
+
+## Simulate @fullscreen
+
+**Try out your code in the simulator!**
+
+Click the center button on the EV3 Brick in the web page. It should display the mood you selected on the screen. Don't hesitate to use the simulator to try out your code during this tutorial!
+
+![EV3 Brick simulator](/static/getting-started/simulate.png)
+
+## Play some tunes @fullscreen
+
+Drag a Music ``||music:play sound effect||`` block below the ``||brick:show mood||`` block.
+Change sound effect to ``communication hello``.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    brick.showMood(moods.neutral)
+    music.playSoundEffect(sounds.communicationHello)
+})
+```
+
+## Download to your brick @unplugged
+
+**Download:** Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+### Did It Work?
+
+Verify that the program you just created shows eyes on the Brick Display, and that the EV3 Brick played the sound “Hello!”
+
+![EV3 Brick with eyes on the display](/static/getting-started/05_EyesOn.png)
+
+
+**Well done!**
+
+## Connect a Large Motor @unplugged
+
+Now you will learn to control the Large Motor.
+
+![EV3 Brick with hands connecting Large Motor to Port D](/static/getting-started/06_PlugInLargeMotor.png)
+
+Connect a Large Motor to **Port D** of your EV3 Brick using any of the connector cables.
+
+## Run a motor @fullscreen
+
+Drag a ``||motors:run large A motor||`` block inside the ``||brick:on button||`` block.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeA.run(50)
+})
+```
+
+## Tune your motor @fullscreen
+
+Change ``large motor A`` to ``large motor D``.
+Click on the **(+)** sign and change to ``1`` rotation.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeD.run(50, 1, MoveUnit.Rotations)
+})
+```
+
+## Download @unplugged
+
+**Download:** Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+### Did It Rotate?
+
+Confirm that your motor has turned one rotation at power level 50 before stopping.
+
+Download and run the program as many times as you want in order to verify this, or tinker with different power levels and different rotations.
+
+![Large Motor D w/Rotating “WHRRR,” Hand, EV3 Brick](/static/getting-started/08_WorkingLargeMotor.png)
+
+## Connect a Touch Sensor @unplugged
+
+We will now control the Large Motor using a Touch Sensor.
+
+Keeping the Large Motor connected to **Port D**, connect a Touch Sensor to **Port 1** of your EV3 Brick.
+
+![Hands connecting Touch Sensor to Port 1 on EV3 Brick](/static/getting-started/09_Connect_Touch.png)
+
+## Modify Your Program @fullscreen
+
+* Add a ``||sensors:pause until touch 1 pressed||`` Sensor block on top of the ``||motors:run large motor D||`` block.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    sensors.touch1.pauseUntil(ButtonEvent.Pressed)
+    motors.largeD.run(50, 1, MoveUnit.Rotations)
+})
+```
+
+## Download @unplugged
+
+**Download:** Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+### Press the Touch Sensor
+
+Confirm that the Large Motor has turned one rotation AFTER you press the Touch Sensor.
+
+Download and run the program as many times as you want in order to verify this, or tinker with different Touch Sensor and Large Motor values.
+
+![Hand Touch Sensor Pressed & EV3 Brick & Large Motor](/static/getting-started/11_TouchMotorWorking.png)
+
+## Connect a Color Sensor @unplugged
+
+Now we will try to control the Large Motor using another sensor.
+
+![Hand connecting Color Sensor to Port 4, Large Motor D, EV3 Brick](/static/getting-started/12_ConnectColor.png)
+
+Keeping the Large Motor connected to **Port D**, connect the Color Sensor to **Port 4**.
+
+## Update your code @fullscreen
+
+Using the same program, replace the ``||sensors:pause until touch 1||`` block with a ``||sensors:pause color sensor 3||`` for color block.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    sensors.color3.pauseUntilColorDetected(ColorSensorColor.Green)
+    motors.largeD.run(50, 1, MoveUnit.Rotations)
+})
+```
+
+Don't forget to select the color you want to detect (e.g., green)!
+
+## Download @unplugged
+
+**Download:** Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+### Place a Colored Brick in Front of the Color Sensor
+
+Confirm that the Large Motor has turned one rotation AFTER the Color Sensor has detected the colored brick.
+
+Download and run the program as many times as you want in order to verify this, or tinker with different Color Sensor and Large Motor values.
+
+![IMG: Colored bricks in front of Color Sensor, hands, EV3 Brick](/static/getting-started/14_ColorSensorWorking.png)
+
+## JavaScript @fullscreen
+
+Click on the **JavaScript** tab and change the color the Color Sensor detects to Black, Blue, Green, Yellow, Red, White, or Brown. Use Title Case for the color names.
+
+```typescript
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    sensors.color3.pauseUntilColorDetected(ColorSensorColor.Blue)
+    motors.largeD.run(50, 1, MoveUnit.Rotations)
+})
+```
+
+## Well Done! @unplugged
+
+You have now learned how to control some of the inputs and outputs of the EV3.

docs/getting-started/try.md

@@ -0,0 +1,171 @@
+# Try
+
+Get a quick introduction to programming with EV3.
+
+![Display on EV3 Brick with Music Notes](/static/getting-started/01_EyesOn_Intro.png)
+
+We are excited to help you get started with @boardname@. In this project we will guide you through connecting your EV3 Brick, creating your first program, controlling a Large Motor, a Touch Sensor and a Color Sensor. These steps can take up to 45 minutes.
+
+## Turn on your EV3 Brick
+
+Power on your EV3 Brick by pressing the Center Button.
+
+![Hand pressing power button](/static/getting-started/02_PowerOn.png)
+
+## Connect Your EV3 Brick to Your Device
+
+Use the USB cable to connect your EV3 Brick to your device.
+
+![Computer and cable connected to EV3 Brick](/static/getting-started/03_insert-usb-02.png)
+
+## Create and Run your First Program
+
+**Code it:** Create the program shown here.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    brick.showMood(moods.neutral)
+    music.playSoundEffect(sounds.communicationHello)
+})
+```
+
+* Drag out a ``||brick:on button||`` block from Buttons section in the ``||brick:Brick||`` Toolbox drawer.
+* Drag a Brick Screen ``||brick:show mood||`` block inside the ``||brick:on button||`` block.
+* Change mood to ``neutral``.
+
+```block
+brick.showMood(moods.neutral)
+```
+
+* Drag a Music ``||music:play sound effect||`` block below the ``||brick:show mood||`` block.
+* Change sound effect to ``communication hello``.
+
+```block
+music.playSoundEffect(sounds.communicationHello)
+```
+
+**Download:** Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+## Did It Work?
+
+![EV3 Brick with eyes on the display](/static/getting-started/05_EyesOn.png)
+
+Verify that the program you just created shows eyes on the Brick Display, and that the EV3 Brick played the sound “Hello!”
+
+**Well done!**
+
+## Run it Again
+
+![EV# Brick with Try in BrkProg_Save Folder in File Manager](/static/getting-started/Try-in-file-manager.png)
+
+Use the Brick Buttons and navigate to the File Manager tab.  Open the **BrkProg_SAVE** folder, select **Try** and click the center button to run it again.
+
+## Connect a Large Motor
+
+Now you will learn to control the Large Motor.
+
+![EV3 Brick with hands connecting Large Motor to Port D](/static/getting-started/06_PlugInLargeMotor.png)
+
+Connect a Large Motor to **Port D** of your EV3 Brick using any of the connector cables.
+
+## Create and Run This Program
+
+**Code it:** Create the program shown here.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeD.run(50, 1, MoveUnit.Rotations)
+})
+```
+
+* Start a new program.
+* Drag a ``||motors:run large A motor||`` block inside the ``||brick:on button||`` block.
+* Change ``large motor A`` to ``large motor D``.
+* Click on the **(+)** sign.
+* Change to ``1`` rotation.
+
+**Download:** Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+## Did It Rotate?
+
+Confirm that your motor has turned one rotation at power level 50 before stopping.
+
+![Large Motor D w/Rotating “WHRRR,” Hand, EV3 Brick](/static/getting-started/08_WorkingLargeMotor.png)
+
+Download and run the program as many times as you want in order to verify this, or tinker with different power levels and different rotations.
+
+## Connect a Touch Sensor
+
+We will now control the Large Motor using a Touch Sensor.
+
+![Hands connecting Touch Sensor to Port 1 on EV3 Brick](/static/getting-started/09_Connect_Touch.png)
+
+Keeping the Large Motor connected to **Port D**, connect a Touch Sensor to **Port 1** of your EV3 Brick.
+
+## Modify Your Program
+
+**Code it:** Add code to the program for the Touch Sensor.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    sensors.touch1.pauseUntil(ButtonEvent.Pressed)
+    motors.largeD.run(50, 1, MoveUnit.Rotations)
+})
+```
+
+* Add a ``||sensors:pause until touch 1 pressed||`` Sensor block on top of the ``||motors:run large motor D||`` block.
+
+```block
+sensors.touch1.pauseUntil(ButtonEvent.Pressed)
+```
+
+**Download:** Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+## Press the Touch Sensor
+
+Confirm that the Large Motor has turned one rotation AFTER you press the Touch Sensor.
+
+![Hand Touch Sensor Pressed & EV3 Brick & Large Motor](/static/getting-started/11_TouchMotorWorking.png)
+
+Download and run the program as many times as you want in order to verify this, or tinker with different Touch Sensor and Large Motor values.
+
+## Connect a Color Sensor
+
+Now we will try to control the Large Motor using another sensor.
+
+![Hand connecting Color Sensor to Port 4, Large Motor D, EV3 Brick](/static/getting-started/12_ConnectColor.png)
+
+Keeping the Large Motor connected to **Port D**, connect the Color Sensor to **Port 4**.
+
+**Code it:** Modify Your Program to use the Color Sensor.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    sensors.color4.pauseUntilColorDetected(ColorSensorColor.Green)
+    motors.largeD.run(50, 1, MoveUnit.Rotations)
+})
+```
+
+* Using the same program, replace the ``||sensors:pause until touch 1||`` block with a ``||sensors:pause color sensor 4||`` for color block.
+
+```block
+sensors.color4.pauseUntilColorDetected(ColorSensorColor.Green)
+```
+
+* Select the color you want to detect (e.g., green).
+
+**Download:** Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+## Place a Colored Brick in Front of the Color Sensor
+
+![IMG: Colored bricks in front of Color Sensor, hands, EV3 Brick](/static/getting-started/14_ColorSensorWorking.png)
+
+Confirm that the Large Motor has turned one rotation AFTER the Color Sensor has detected the colored brick.
+
+Download and run the program as many times as you want in order to verify this, or tinker with different Color Sensor and Large Motor values.
+
+Click on the **JavaScript** tab and change the color the Color Sensor detects to Black, Blue, Green, Yellow, Red, White, or Brown. Use Title Case for the color names.
+
+## Well Done!
+
+You have now learned how to control some of the inputs and outputs of the EV3.

docs/getting-started/use.md

@@ -0,0 +1,121 @@
+# Use
+
+Build a robot and drive into the world of robotics!
+
+![EV3 Driving Base full w/cuboid](/static/getting-started/EV3_GettingStarted_13.jpg)
+
+In this project we will guide you through building a Driving Base Robot and programming it to move straight and turn. You will also build and Object Detector Module, and program it to detect an object. It’s a good idea to have done the [Try](/getting-started/try) sequence first.
+
+## Connect
+
+What if your school had a multipurpose robot? How would you use it?
+
+![Apple Picker Robot](/static/getting-started/02_ApplePickerRobot.jpg)
+
+Would you use it to clean the school or plant trees?
+
+## Build Your Driving Base Robot
+
+Build the robot driving base:
+
+[![EV3 Driving Base](/static/lessons/common/ev3-driving-base.jpg)](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-rem-driving-base-79bebfc16bd491186ea9c9069842155e.pdf)
+
+### ~hint
+
+If clicking the above image doesn't open the instructions, right-click on the image and choose "Save link as..." to download the PDF.
+
+### ~
+
+## Make It Move
+
+**Code it:** Create a program that makes the Driving Base move forward and stop at the finish line, which is ``1`` meter away.
+
+Start by building this program:
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeBC.steer(0, 50, 1, MoveUnit.Rotations)
+})
+```
+
+* Drag a ``||motors:steer large motors B+C||`` block inside an ``||brick:on button||`` block.
+* Click on the **(+)** sign.
+* Change to ``1`` rotation.
+
+### ~hint
+
+**Hint:** You will have to modify the number of rotations until you find the number that matches the robot moving forward 1 meter and stopping.
+
+### ~
+
+**Download:** Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+## Make It Turn
+
+**Code it:** Create a new program that turns the Driving Base 180 degrees.
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeBC.steer(-50, 50, 1, MoveUnit.Rotations)
+})
+```
+
+### ~hint
+
+**Hint:** You will have to modify the turn ratio and the number of rotations until the robot reaches 180 degrees.
+
+### ~
+
+**Download:** Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+## Add an Ultrasonic Sensor to Your Driving Base
+
+Build and attach an Ultrasonic Sensor to your driving base:
+
+[![EV3 Ultrasonic Sensor Driving Base Building Instructions Main Image](/static/lessons/common/ev3-ultrasonic-sensor-driving-base.jpg)](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-ultrasonic-sensor-driving-base-61ffdfa461aee2470b8ddbeab16e2070.pdf)
+
+### ~hint
+
+If clicking the above image doesn't open the instructions, right-click on the image and choose "Save link as..." to download the PDF.
+
+### ~
+
+## Detect an Object
+
+**Code it:**  Create a program that moves the Driving Base and makes it stop ``6`` cm from the Cuboid.
+
+Create a new program:
+
+```blocks
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeBC.tank(50, 50)
+    sensors.ultrasonic4.setThreshold(UltrasonicSensorEvent.ObjectDetected, 6)
+    sensors.ultrasonic4.pauseUntil(UltrasonicSensorEvent.ObjectDetected);
+    motors.stopAll()
+})
+```
+
+* Drag a ``||motors:tank large motors B+C||`` motor block inside the ``||brick:on button||`` block.
+* Drag the Ultrasonic Sensor threshold ``||sensors:set ultrasonic 4||``  block and place it below the motor block.
+* Drag a ``|sensors:pause until ultrasonic 4||`` block and place it under the threshold block.
+* Drag a ``||motors:stop all motors||`` block and place it below the sensor block.
+
+### ~hint
+
+**Hint:** You will have to modify the values of the Ultrasonic Sensor block until the robot reaches the desired position.
+
+### ~
+
+**Download:** Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the center button on the EV3 Brick to run the program.
+
+Click on the **JavaScript** tab. Change and test the number value of the Ultrasonic
+Sensor.
+
+```typescript
+sensors.ultrasonic4.setThreshold(UltrasonicSensorEvent.ObjectDetected, 10)
+```
+
+**Congratulations!**
+
+You are ready to move on to the next steps.
+Try a [Design Engineering](/design-engineering), [Coding](/coding), or [Maker](/maker) activity.

docs/index-ref.json

@@ -1,3 +1,3 @@
 {
-    "appref": "v0.0.104"
+    "appref": "v1.2.22"
 }

docs/labview.md

@@ -1,6 +1,6 @@
 # Coding in MakeCode
 
-This guide helps users who are used to the LabView LEGO Minstorms editor quickly get familiar with using blocks in MakeCode.
+This guide helps users who are used to work with @boardname@ to get familiar with using blocks in MakeCode.
 
 ## Snap together the blocks
 
@@ -29,9 +29,9 @@ motors.largeA.stop()
 
 ## Download to the EV3
 
-Before you actually run your program on the @boardname@, you can first try it in the simulator. The MakeCode editor includes a simulator in the browser for you to test your code. You can make changes to your program and check them out it the simulator to make sure your code works the way want. The similator knows when you modify your code and it restarts automatically to run the new code.
+Before you actually run your program on the EV3 Brick, you can first try it in the simulator. The MakeCode editor includes a simulator in the browser for you to test your code. You can make changes to your program and check them out it the simulator to make sure your code works the way want. The similator knows when you modify your code and it restarts automatically to run the new code.
 
-Once you're ready to transfer your program to the @boardname@, click the ``|Download|`` button and follow the instructions.
+Once you're ready to transfer your program to the EV3 Brick, click the ``|Download|`` button and follow the instructions.
 
 ## Single motors
 
@@ -61,6 +61,12 @@ motors.largeBC.steer(0, 50, 1, MoveUnit.Rotations);
 motors.largeBC.stop();
 ```
 
+### ~ hint
+
+The **turn ratio range is -200, 200** unlike LabView who used -100,100.
+
+### ~
+
 ## Tank
 
 The **tank** blocks control the speed of two motors. These are commonly used for a differential drive robot. The blocks can also specify the duration, angle, or number of rotations.

docs/lessons.md

@@ -1,6 +1,6 @@
 # Lessons
 
-Learning activities for LEGO Mindstorms with MakeCode.
+Learning activities for @boardname@ with MakeCode.
 
 ## Motors and motion
 

docs/lessons/line-detection.md

@@ -3,7 +3,7 @@
 ## Objective
 
 Design ways to improve driving safety by helping to prevent drivers from falling asleep and causing an accident.
- 
+
 ![Car driving on highway](/static/lessons/line-detection/car-driving.jpg)
 
 ## Connect
@@ -20,6 +20,12 @@ Think about what you have learned, then document it. Describe the problem in you
 
 Start by constructing this model. Read the building instructions [here](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-rem-color-sensor-down-driving-base-d30ed30610c3d6647d56e17bc64cf6e2.pdf) first.
 
+### ~hint
+
+If clicking the above image doesn't open the instructions, right-click on the image and choose "Save link as..." to download the PDF.
+
+### ~
+
 ![Color sensor on the driving base](/static/lessons/line-detection/color-sensor-driving.jpg)
 
 ## Program
@@ -44,13 +50,13 @@ Create a program that drives the robot forward until the Color Sensor sees red.
 
 Place a ``||motors:steer large B+C||`` block from ``||motors:Motors||`` under ``||loops:on start||``. Change the speed to 20%.
 
-```blocks 
+```blocks
 motors.largeBC.steer(0, 20)
 ```
 
 ### Step 2
 
-Place a ``||loops:while||`` loop block under ``||motors:steer large B+C||``.  
+Place a ``||loops:while||`` loop block under ``||motors:steer large B+C||``.
 
 ```blocks
 motors.largeBC.steer(0, 20)
@@ -60,18 +66,18 @@ while (true) {
 
 ### Step 3
 
-Place a ``||sensors:pause for color||`` from ``||sensors:Sensors||`` inside the ``||loops:while||`` loop block. Change the color to red.
- 
+Place a ``||sensors:pause until color detected||`` from ``||sensors:Sensors||`` inside the ``||loops:while||`` loop block. Change the color to red.
+
 ```blocks
 motors.largeBC.steer(0, 20)
 while (true) {
-    sensors.color3.pauseForColor(ColorSensorColor.Red)
+    sensors.color3.pauseUntilColorDetected(ColorSensorColor.Red)
 }
 ```
 
 ### Step 4
 
-Place a ``||motors:stop all motors||`` block under the ``||sensors:pause for color||`` block.
+Place a ``||motors:stop all motors||`` block under the ``||sensors:pause until color detected||`` block.
 
 Study the program...what do you think the program will do?
 
@@ -80,7 +86,7 @@ Study the program...what do you think the program will do?
 ```blocks
 motors.largeBC.steer(0, 20)
 while (true) {
-    sensors.color3.pauseForColor(ColorSensorColor.Red)
+    sensors.color3.pauseUntilColorDetected(ColorSensorColor.Red)
     motors.stopAll()
 }
 ```
@@ -99,7 +105,7 @@ Place a ``||loops:while||`` loop block under ``||loops:on start||``.
 
 ```blocks
 while (true) {
-    
+
 }
 ```
 
@@ -121,33 +127,33 @@ Place a ``||loops:while||`` loop block under the ``||motors:steer large B+C||``
 while (true) {
     motors.largeBC.steer(0, 20)
     while (true) {
-        
+
     }
 }
 ```
 
 ### Step 5
 
-Place a ``||sensors:pause for color||`` block from ``||sensors:Sensors||`` inside the ``||loops:while||`` loop block. Change the color to red.
+Place a ``||sensors:pause until color detected||`` block from ``||sensors:Sensors||`` inside the ``||loops:while||`` loop block. Change the color to red.
 
 ```blocks
 while (true) {
     motors.largeBC.steer(0, 20)
     while (true) {
-        sensors.color3.pauseForColor(ColorSensorColor.Red)
+        sensors.color3.pauseUntilColorDetected(ColorSensorColor.Red)
     }
 }
 ```
 
 ### Step 6
 
-Place a ``||motors:stop all motors||`` block under the ``||sensors:pause for color||`` block.  
+Place a ``||motors:stop all motors||`` block under the ``||sensors:pause until color detected||`` block.
 
 ```blocks
 while (true) {
     motors.largeBC.steer(0, 20)
     while (true) {
-        sensors.color3.pauseForColor(ColorSensorColor.Red)
+        sensors.color3.pauseUntilColorDetected(ColorSensorColor.Red)
         motors.stopAll()
     }
 }
@@ -161,32 +167,32 @@ Place a ``||loops:while||`` loop block under the second ``||loops:while||`` loop
 while (true) {
     motors.largeBC.steer(0, 20)
     while (true) {
-        sensors.color3.pauseForColor(ColorSensorColor.Red)
+        sensors.color3.pauseUntilColorDetected(ColorSensorColor.Red)
         motors.stopAll()
     }
     while (true) {
-        
+
     }
 }
 ```
 
 ### Step 8
 
-Place a ``||sensors:pause for color||`` block inside the new ``||loops:while||`` loop block. Change the color to red.
+Place a ``||sensors:pause unril color detected||`` block inside the new ``||loops:while||`` loop block. Change the color to red.
 
 What do you think the program will do?
 
 **Hint:** The motors will run until the Color Sensor detects the color red, then it will stop all motors. The motors will also run and not stop when the color sensor detects the color green.
- 
+
 ```blocks
 while (true) {
     motors.largeBC.steer(0, 20)
     while (true) {
-        sensors.color3.pauseForColor(ColorSensorColor.Red)
+        sensors.color3.pauseUntilColorDetected(ColorSensorColor.Red)
         motors.stopAll()
     }
     while (true) {
-        sensors.color3.pauseForColor(ColorSensorColor.Red)
+        sensors.color3.pauseUntilColorDetected(ColorSensorColor.Red)
     }
 }
 ```
@@ -208,16 +214,17 @@ Think about what you have learned, then document it. Describe your pseudocode fo
 ```blocks
 motors.largeBC.steer(0, 20)
 while (true) {
-sensors.color3.pauseForColor(ColorSensorColor.Yellow)
+sensors.color3.pauseUntilColorDetected(ColorSensorColor.Yellow)
 music.playSoundEffect(sounds.systemGeneralAlert)
 }
 while (true) {
-    while (true) {      sensors.color3.pauseForLight(LightIntensityMode.Reflected, LightCondition.Bright)
+    while (true) {
+        sensors.color3.pauseUntilLightDetected(LightIntensityMode.Reflected, Light.Bright)
         motors.largeB.run(10)
         motors.largeC.run(-10)
     }
     while (true) {
-        sensors.color3.pauseForLight(LightIntensityMode.Reflected, LightCondition.Bright)
+        sensors.color3.pauseUntilLightDetected(LightIntensityMode.Reflected, Light.Bright)
         motors.largeA.run(-10)
         motors.largeA.run(10)
     }
@@ -234,12 +241,13 @@ You will need to constantly debug your program in order to make your robot trave
 
 ```blocks
 while (true) {
-    while (true) {   sensors.color3.pauseForLight(LightIntensityMode.Reflected, LightCondition.Bright)
+    while (true) {
+        sensors.color3.pauseUntilLightDetected(LightIntensityMode.Reflected, Light.Bright)
         motors.largeB.run(10)
         motors.largeC.run(-10)
     }
     while (true) {
-        sensors.color3.pauseForLight(LightIntensityMode.Reflected, LightCondition.Bright)
+        sensors.color3.pauseUntilLightDetected(LightIntensityMode.Reflected, Light.Bright)
         motors.largeB.run(-10)
         motors.largeC.run(10)
     }
@@ -250,10 +258,10 @@ while (true) {
 
 Consider the following questions:
 
-1. What challenged you? 
-2. Where there any surprises? 
+1. What challenged you?
+2. Where there any surprises?
 3. How could you improve your program?
-4. Could your program have been more streamlined? 
+4. Could your program have been more streamlined?
 5. Have you used too many blocks?
 6. Is there a more efficient way of building your program?
 7. How could your program be used in real-world scenarios?

docs/lessons/make-it-move-tutorial.md

@@ -1,4 +1,4 @@
-# Make It Move Without Wheels 
+# Make It Move Without Wheels
 
 ## Objective @unplugged
 
@@ -10,7 +10,7 @@ Your robot will:
 * Use at least one motor
 * Use NO wheels for locomotion
 
-![LECG Mindstorms brick with parts](/static/lessons/make-it-move/locomotion-no-wheels.jpg)
+![@boardname@ with parts](/static/lessons/make-it-move/locomotion-no-wheels.jpg)
 
 
 ## Construct @unplugged
@@ -24,8 +24,14 @@ The Walker Bot combines an EV3 Frame and two legs that are mirror-images to crea
 The legs in the Walker Bot are designed to show how to change the rotary motion of a motor to reciprocating motion.
 
 Start by reading [these](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/ev3-dep/building%20instructions/walker-bot-bi-180fc24f9298e1dd6201099627d43903.pdf) instructions first.
- 
-![LEGO Mindstorms Walker Bot](/static/lessons/make-it-move/walker-bot.jpg)
+
+### ~hint
+
+If clicking the above image doesn't open the instructions, right-click on the image and choose "Save link as..." to download the PDF.
+
+### ~
+
+![@boardname@ Walker Bot](/static/lessons/make-it-move/walker-bot.jpg)
 
  
 ## Program 1 @fullscreen
@@ -37,7 +43,7 @@ Place a ``||motors:tank large B+C||`` block from ``||motors:Motors||`` under ``|
 Change the speed to `-60%` (for motor B) and `+60%` (for motor C).
 Change the rotations to `9`.
 
-The ``||motors:tank large B+C||`` block will run for `9` rotations when the **center** button is pressed on the EV3 brick. The motors are set for the reverse direction because they are mounted upside down in this model.
+The ``||motors:tank large B+C||`` block will run for `9` rotations when the **center** button is pressed on the EV3 Brick. The motors are set for the reverse direction because they are mounted upside down in this model.
 
 ```blocks
 motors.largeBC.tank(-60, 60, 9, MoveUnit.Rotations)
@@ -47,7 +53,7 @@ motors.largeBC.tank(-60, 60, 9, MoveUnit.Rotations)
 
 Place a ``||motors:stop all motors||`` block under ``||motors:tank large B+C||``.
 
-The ``||motors:tank large B+C||`` block will run for `9` rotations when the **center** button is pressed on the EV3 brick then stop.
+The ``||motors:tank large B+C||`` block will run for `9` rotations when the **center** button is pressed on the EV3 Brick then stop.
 
 ```blocks
 motors.largeBC.tank(-60, 60, 9, MoveUnit.Rotations)
@@ -59,7 +65,7 @@ motors.stopAll()
 Place a ``||brick:show string||`` block under ``||motors:stop all motors||``.
 Change the `"Hello World"` text to `"30 cm"`.
 
-The ``||motors:tank large B+C||`` will run for `9` rotations when the **center** button is pressed on the EV3 brick then stop and display "30 cm" on the EV3 Brick’s screen.
+The ``||motors:tank large B+C||`` will run for `9` rotations when the **center** button is pressed on the EV3 Brick then stop and display "30 cm" on the EV3 Brick’s screen.
 
 ```blocks
 motors.largeBC.tank(-60, 60, 9, MoveUnit.Rotations)

docs/lessons/make-it-move.md

@@ -1,4 +1,4 @@
-# Make It Move Without Wheels 
+# Make It Move Without Wheels
 
 ## Objective
 
@@ -10,7 +10,7 @@ Your robot will:
 * Use at least one motor
 * Use NO wheels for locomotion
 
-![LECG Mindstorms brick with parts](/static/lessons/make-it-move/locomotion-no-wheels.jpg)
+![@boardname@ with parts](/static/lessons/make-it-move/locomotion-no-wheels.jpg)
 
 ## Construct
 
@@ -23,8 +23,14 @@ The Walker Bot combines an EV3 Frame and two legs that are mirror-images to crea
 The legs in the Walker Bot are designed to show how to change the rotary motion of a motor to reciprocating motion.
 
 Start by reading [these](https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/ev3-dep/building%20instructions/walker-bot-bi-180fc24f9298e1dd6201099627d43903.pdf) instructions first.
- 
-![LEGO Mindstorms Walker Bot](/static/lessons/make-it-move/walker-bot.jpg)
+
+### ~hint
+
+If clicking the above image doesn't open the instructions, right-click on the image and choose "Save link as..." to download the PDF.
+
+### ~
+
+![@boardname@ Walker Bot](/static/lessons/make-it-move/walker-bot.jpg)
 
  
 ## Program
@@ -38,7 +44,7 @@ Place a ``||motors:tank large B+C||`` block from ``||motors:Motors||`` under ``|
 Change the speed to `-60%` (for motor B) and `+60%` (for motor C).
 Change the rotations to `9`.
 
-The ``||motors:tank large B+C||`` block will run for `9` rotations when the **center** button is pressed on the EV3 brick. The motors are set for the reverse direction because they are mounted upside down in this model.
+The ``||motors:tank large B+C||`` block will run for `9` rotations when the **center** button is pressed on the EV3 Brick. The motors are set for the reverse direction because they are mounted upside down in this model.
 
 ```blocks
 motors.largeBC.tank(-60, 60, 9, MoveUnit.Rotations)
@@ -48,7 +54,7 @@ motors.largeBC.tank(-60, 60, 9, MoveUnit.Rotations)
 
 Place a ``||motors:stop all motors||`` block under ``||motors:tank large B+C||``.
 
-The ``||motors:tank large B+C||`` block will run for `9` rotations when the **center** button is pressed on the EV3 brick then stop.
+The ``||motors:tank large B+C||`` block will run for `9` rotations when the **center** button is pressed on the EV3 Brick then stop.
 
 ```blocks
 motors.largeBC.tank(-60, 60, 9, MoveUnit.Rotations)
@@ -60,7 +66,7 @@ motors.largeBC.stop()
 Place a ``||brick:show string||`` block under ``||motors:stop all motors||``.
 Change the `"Hello World"` text to `"30 cm"`.
 
-The ``||motors:tank large B+C||`` will run for `9` rotations when the **center** button is pressed on the EV3 brick then stop and display "30 cm" on the EV3 Brick’s screen.
+The ``||motors:tank large B+C||`` will run for `9` rotations when the **center** button is pressed on the EV3 Brick then stop and display "30 cm" on the EV3 Brick’s screen.
 
 ```blocks
 motors.largeBC.tank(-60, 60, 9, MoveUnit.Rotations)

docs/maker.md

@@ -1,19 +1,23 @@
 # Maker Activites
 
-These six activities require the LEGO® MINDSTORMS® Education EV3 Core Set (45544). Supporting materials for teachers and middle school students are provided, offering everything teachers and students need to explore their inner makers as they follow the design process to solve open-ended, themed challenges...
-
-* [Download Curriculum Materials](https://education.lego.com/en-us/downloads/mindstorms-ev3)
-
 ## Activites
 
 ```codecard
 [
 {
   "name": "Make A Sound Machine",
-  "description": "Create instruments with your EV3 Brick!",
+  "description": "Make a Sound Machine that can play a rhythm, music or just noise!",
   "url":"/maker/sound-machine",
   "cardType": "example",
-  "imageUrl": "/static/maker/sound-machine.png",
+  "imageUrl": "/static/lessons/make-a-sound-machine.png",
+  "cardType": "side"  
+},
+{
+  "name": "Make A Security Gadget",
+  "description": "Invent a Security Gadget that will protect your belongings by warning you!",
+  "url":"/maker/security-gadget",
+  "cardType": "example",
+  "imageUrl": "/static/lessons/make-a-security-device.png",
   "cardType": "side"  
 }
 ]

docs/maker/movement-detector.md

@@ -1,4 +1,4 @@
-# Intruder Detector
+# Movement Detector
 
 This program will activate an alarm when an object moves in front of the Ultrasonic Sensor.
 

docs/maker/security-gadget.md

@@ -1,9 +1,139 @@
-# Security Gadget
 
-This program will activate an alarm when an object is lifted from the Touch Sensor.
+# Make a Security Gadget
+
+Invent a Security Gadget that will protect your belongings by warning you!
+
+![Maker – Make a Security Gadget Main Image](/static/lessons/make-a-security-gadget/lego-maker-security-detect.jpg)
+
+## Connect 
+
+Over time, people have come up with many different ways to help protect their personal belongings from theft. These inventions include simple alarm systems and even traps! 
+
+![Make a Security Gadget 3 Stock Footage Images](/static/lessons/make-a-security-gadget/three-stock.jpg)
+
+Look at the photos and think about:
+
+* What do you see?
+* Can you see any new design opportunities?
+* What problems can you see?
+* How could you make use of the LEGO bricks, the EV3 Programmable Brick, motors, and sensors?
+
+### Things You’ll Need
+
+* [@boardname@ Core Set](https://education.lego.com/enus/products/legomindstormseducationev3coreset/5003400)
+
+Additional materials to add to your Security Gadget:
+
+* String
+* Arts and crafts materials such as:
+>* Cardboard
+>* Construction paper
+>* Pipe cleaners
+>* Plastic or paper cups 
+>* Recycled materials
+>* Rubber bands
+>* Wire
+
+### Prior Knowledge
+
+This activity uses sensor inputs. You may want to try the [Use](/getting-started/use) or [Object Detection](/coding/object-detection) activity before this one. Or, you can start out with this activity and tinker with coding sensor inputs on your own.
+
+## Contemplate
+
+Follow the steps of the _Maker Design Process_ for this lesson:
+
+* Define the Problem
+* Brainstorming
+* Define the Design Criteria
+* Go Make
+* Review and Revise Your Solution
+* Communicate Your Solution
+
+### Defining the Problem
+
+1. What problems did you imagine? 
+2. Pick one problem and explain it to a partner.
+
+### Brainstorm
+
+Now that you have defined a problem, start to generate ideas for solving it. 
+
+### ~hint
+
+Some things to do while brainstorming:
+
+* Use the bricks from the LEGO set to help you brainstorm or sketch your ideas on paper.
+* The goal of brainstorming is to explore as many solutions as possible. You can use the tinkering examples in the Sample Solutions section below as inspiration for getting started.
+* Share your ideas and get some feedback. It may lead to more ideas!
+
+### ~ 
+
+### Define the Design Criteria
+
+1. You should have generated a number of ideas. Now select the best one to make. 
+2. Write out two or three specific design criteria your design must meet.
+
+### Go Make
+
+It is time to start making!
+
+* Use the components from the @boardname@ Core Set and additional materials to make your chosen solution. 
+* Test and analyze your design as you go and record any improvements that you make. 
+
+### Review and Revise Your Solution
+
+* Have you managed to solve the problem that you defined? 
+* Look back at your design criteria. How well does your solution work? 
+* How can you improve your design?
+
+### Communicate Your Solution
+
+Now that you have finished you can:
+
+* Make a sketch or take a photo or video of your model.
+* Label the three most important parts and explain how they work.
+* Share your work with others.
+
+## Continue
+
+### Phone Protector - Sample Solution
+
+This example program combined with the small model will sound an alarm if someone picks it up. The program activates an alarm when an object is lifted from the Touch Sensor.
+
+![Security Gadget Tinkering Example #1 – Phone Stand](/static/lessons/make-a-security-gadget/lego-maker-security-gadget.jpg)
+
+#### Programming
+
+1. Drag a ``||sensors:pause until touch||`` block and place it inside the ``||loops:forever||`` loop.
+2. Drag a ``||music:play sound effect||`` block and place it below the ``||sensors:pause until||`` block.
+3. Change the sound effect to ``mechanical horn1``.
 
 ```blocks
-sensors.touch1.onEvent(ButtonEvent.Released, function () {
-    music.playSoundEffectUntilDone(sounds.informationActivate);
+forever(function () {
+    sensors.touch1.pauseUntil(ButtonEvent.Pressed)
+    music.playSoundEffect(sounds.mechanicalHorn1)
 })
-```
+```
+
+Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the ``center`` button on the EV3 Brick to run the program.
+
+### Object Detection - Sample Solution
+
+This example program combined with the small model will sound an alarm if someone (or something) crosses its path! The program activates an alarm when an object moves in front of the Ultrasonic Sensor.
+
+![Security Gadget Tinkering Example #1 – Mouse detector](/static/lessons/make-a-security-gadget/lego-maker-security-detect.jpg)
+
+#### Programming
+
+1. Drag a ``||sensors:pause until ultrasonic||`` block and place it inside the ``||loops:forever||`` loop.
+2. Drag a ``||music:play sound effect||`` block and place it below the ``||sensors:pause until||`` block.
+3. Change the sound effect to ``mechanical horn1``.
+
+```blocks
+forever(function () {
+    sensors.ultrasonic4.pauseUntil(UltrasonicSensorEvent.ObjectDetected)
+    music.playSoundEffect(sounds.mechanicalHorn1)
+})
+```
+
+Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the ``center`` button on the EV3 Brick to run the program.

docs/maker/sound-machine.md

@@ -1,12 +1,163 @@
-# Sound Machine
+# Make a Sound Machine
+
+Make a Sound Machine that can play a rhythm, music or just noise!
+
+![Maker – Make a Sound Machine Main Image](/static/lessons/make-a-sound-machine/lego-maker-sound-machine-1.jpg)
+
+## Connect 
+
+Music is made up of a combination of sounds, notes and rhythm. A rhythm is a regular movement or repeated pattern of movements that can be used in many different ways. In mechanical machines, a rhythm can help keep a machine running smoothly. It can also be used to generate different sounds in music. 
+
+![Sound Machine 3 Stock Footage Images](/static/lessons/make-a-sound-machine/three-stock.jpg)
+
+Look at the photos and think about:
+
+* What do you see?
+* Can you see any new design opportunities?
+* What problems can you see?
+* How could you make use of the LEGO bricks, the EV3 Programmable Brick, motors, and sensors?
+
+### Things You’ll Need
+
+* [@boardname@ Core Set](https://education.lego.com/enus/products/legomindstormseducationev3coreset/5003400)
+
+Additional materials to add to your Sound Machine:
+
+* Small musical instruments, such as chimes, bells, and small drums
+* Arts and crafts materials such as:
+>* Cardboard
+>* Construction paper
+>* Pipe cleaners
+>* Plastic or paper cups 
+>* Recycled materials
+>* Rubber bands
+>* Wire
+
+### Prior Knowledge
+
+This activity uses motor rotations and sensor inputs. You may want to try the [Use](/getting-started/use) or [Object Detection](/coding/object-detection) activity before this one. Or, you can start out with this activity and tinker with coding motor and sensor inputs on your own.
+
+## Contemplate
+
+Follow the steps of the _Maker Design Process_ for this lesson:
+
+* Define the Problem
+* Brainstorming
+* Define the Design Criteria
+* Go Make
+* Review and Revise Your Solution
+* Communicate Your Solution
+
+### Defining the Problem
+
+1. What problems did you imagine? 
+2. Pick one problem and explain it to a partner.
+
+### Brainstorm
+
+Now that you have defined a problem, start to generate ideas for solving it. 
+
+### ~hint
+
+Some things to do while brainstorming:
+
+* Use the bricks from the LEGO set to help you brainstorm or sketch your ideas on paper.
+* The goal of brainstorming is to explore as many solutions as possible. You can use the tinkering examples in the Sample Solutions section below as inspiration for getting started.
+* Share your ideas and get some feedback. It may lead to more ideas!
+
+### ~
+
+### Define the Design Criteria
+
+* You should have generated a number of ideas. Now select the best one to make. 
+* Write out two or three specific design criteria your design must meet.
+
+### Go Make
+
+It is time to start making!
+
+* Use the components from the @boardname@ Core Set and additional materials to make your chosen solution. 
+* Test and analyze your design as you go and record any improvements that you make. 
+
+### Review and Revise Your Solution
+
+* Have you managed to solve the problem that you defined? 
+* Look back at your design criteria. How well does your solution work? 
+* How can you improve your design?
+
+### Communicate Your Solution
+
+Now that you have finished you can:
+* Make a sketch or take a photo or video of your model.
+* Label the three most important parts and explain how they work.
+* Share your work with others.
+
+## Continue
+
+### Rhythm Maker - Sample Solution
 
 This example program combined with the small model will make a beat and rhythm on any surface when the program is run.
 
+![Sound Machine Tinkering Example](/static/lessons/make-a-sound-machine/lego-maker-sound-machine.jpg)
+
+#### Programming
+
+1. Drag a run ``||motors:large motor A||`` block inside the ``||loops:forever||`` loop.
+2. Press the **(+)**.
+3. Change the rotations to `2`.
+4. Drag a ``||loops:pause||`` block and place it under the motor block.
+5. Change the duration to ``200`` ms.
+6. Drag a ``||run large motor A||`` block inside the ``||loops:forever||`` loop.
+7. Press the **(+)**.
+8. Change the power to `100`.
+9. Change the rotations to `1`.
+
 ```blocks
 forever(function () {
-    motors.largeA.run(50)
-    pause(200)
-    motors.largeA.run(100)
+    motors.largeA.run(50, 2, MoveUnit.Rotations)
     pause(200)
+    motors.largeA.run(100, 1, MoveUnit.Rotations)
 })
-``` 
+```
+
+Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the ``center`` button on the EV3 Brick to run the program.
+
+### Color Sensor Sounds - Sample Solution
+
+You can also tinker with the use of sensors.
+
+![Sound Machine Color Sensor](/static/lessons/make-a-sound-machine/lego-maker-sound-machine-color-sensor.jpg)
+
+#### Programming
+
+1. Drag an ``||logic:if else||`` Logic block and place it inside the ``||loops:forever||`` loop.
+2. Drag a ``||sensors:pause color sensor||`` block and place it inside the ``||logic:if true then||`` block.
+3. Change the color to ``blue``.
+4. Drag a ``||music:play tone||`` block and place under the sensor block.
+5. Change the tone to ``Middle G`` (392 Hz).
+6. Drag a ``||sensors:pause color sensor||`` block and place it inside the ``||logic:else||`` block.
+7. Change the color to ``red``.
+8. Drag a ``||music:play tone||`` block and place under the new sensor block.
+9. Change the tone to ``High C`` (523 Hz).
+10. Press the **(+)**.
+11. Drag a ``||sensors:pause color sensor||`` block and place it inside the ``||logic:else if||`` block.
+12. Change the color to ``green``.
+13. Drag a ``||music:play tone||`` block and place under the new sensor block.
+14. Change the tone to ``High D`` (587 Hz).
+
+```blocks
+forever(function () {
+    if (true) {
+        sensors.color3.pauseUntilColorDetected(ColorSensorColor.Blue)
+        music.playTone(392, music.beat(BeatFraction.Whole))
+    } else if (false) {
+        sensors.color3.pauseUntilColorDetected(ColorSensorColor.Red)
+        music.playTone(523, music.beat(BeatFraction.Half))
+    } else {
+        sensors.color3.pauseUntilColorDetected(ColorSensorColor.Green)
+        music.playTone(587, music.beat(BeatFraction.Half))
+    }
+})
+```
+
+Click **Download** and follow the instructions to get your code onto your EV3 Brick. Press the ``center`` button on the EV3 Brick to run the program.

docs/offline-app.html

@@ -0,0 +1,791 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" xmlns:og="http://ogp.me/ns#" xmlns:fb="http://www.facebook.com/2008/fbml">
+
+<head>
+    <meta charset="UTF-8">
+    <title>LEGO® MINDSTORMS® Education EV3 Offline App</title>
+    <meta name="Description" content="A MakeCode for LEGO® MINDSTORMS® Education EV3 offline app" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <!-- @include indexhead.html -->
+
+    <style>
+        p.item {
+            color: rgba(0, 0, 0, 0.4);
+        }
+
+        .topbar {
+            background: rgb(170, 39, 143) !important;
+        }
+
+        .ui.inverted.content {
+            /* background: #00a5c8; */
+            background: #2a7af3;
+        }
+
+        .content.segment {
+            min-height: 80%;
+        }
+
+        .content .welcomeheader {
+            font-weight: 300;
+        }
+
+        .footer.segment {
+            padding: 5em 0em;
+        }
+
+        .image.left {
+            padding-left: 2em;
+        }
+
+        .image.right {
+            padding-right: 2em;
+            float: right;
+        }
+
+        .segments {
+            max-width: 60%;
+        }
+
+        .segments.terms-container {
+            margin-top: 5em;
+        }
+
+        .terms-container .segment {
+            background-color: rgb(250, 250, 250);
+        }
+
+        @media only screen and (max-width: 800px) {
+            .grid .column .image {
+                display: none;
+            }
+
+            .segments {
+                max-width: 95%;
+            }
+        }
+    </style>
+
+    <!-- Auto-generated styles for the license terms -->
+    <style type="text/css">
+        .terms ol {
+            margin: 0;
+            padding: 0
+        }
+
+        .terms table td,
+        .terms table th {
+            padding: 0
+        }
+
+        .c2 {
+            margin-left: 22.5pt;
+            padding-top: 6pt;
+            text-indent: -18pt;
+            padding-bottom: 6pt;
+            line-height: 1.15;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .c8 {
+            margin-left: 40.5pt;
+            padding-top: 6pt;
+            text-indent: -18pt;
+            padding-bottom: 6pt;
+            line-height: 1.15;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .c15 {
+            padding-top: 0pt;
+            padding-bottom: 12pt;
+            line-height: 1.15;
+            orphans: 2;
+            widows: 2;
+            text-align: left;
+            height: 11pt
+        }
+
+        .c7 {
+            padding-top: 0pt;
+            padding-bottom: 0pt;
+            line-height: 1.15;
+            orphans: 2;
+            widows: 2;
+            text-align: left;
+            height: 11pt
+        }
+
+        .c0 {
+            margin-left: 23pt;
+            padding-top: 6pt;
+            padding-bottom: 6pt;
+            line-height: 1.15;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .c10 {
+            margin-left: 40.5pt;
+            padding-top: 6pt;
+            padding-bottom: 6pt;
+            line-height: 1.15;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .c6 {
+            margin-left: 40.5pt;
+            padding-top: 0pt;
+            padding-bottom: 0pt;
+            line-height: 1.15;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .c20 {
+            padding-top: 0pt;
+            padding-bottom: 0pt;
+            line-height: 1.15;
+            orphans: 2;
+            widows: 2;
+            text-align: center
+        }
+
+        .c4 {
+            color: #000000;
+            font-weight: 700;
+            text-decoration: none;
+            vertical-align: baseline;
+            font-family: "Arial";
+            font-style: normal
+        }
+
+        .c11 {
+            padding-top: 0pt;
+            padding-bottom: 0pt;
+            line-height: 1.15;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .c12 {
+            padding-top: 6pt;
+            padding-bottom: 6pt;
+            line-height: 1.15;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .c3 {
+            color: #000000;
+            font-weight: 400;
+            text-decoration: none;
+            vertical-align: baseline;
+            font-family: "Arial";
+            font-style: normal
+        }
+
+        .c16 {
+            padding-top: 0pt;
+            padding-bottom: 12pt;
+            line-height: 1.15;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .c13 {
+            color: #000000;
+            text-decoration: none;
+            vertical-align: baseline;
+            font-family: "Arial";
+            font-style: italic
+        }
+
+        .c14 {
+            text-decoration-skip-ink: none;
+            -webkit-text-decoration-skip: none;
+            color: #1155cc;
+            text-decoration: underline
+        }
+
+        .c17 {
+            background-color: #ffffff;
+            max-width: 540pt;
+            padding: 36pt 36pt 36pt 36pt
+        }
+
+        .c18 {
+            text-decoration-skip-ink: none;
+            -webkit-text-decoration-skip: none;
+            text-decoration: underline
+        }
+
+        .c9 {
+            color: inherit;
+            text-decoration: inherit
+        }
+
+        .c5 {
+            font-weight: 700
+        }
+
+        .c1 {
+            font-size: 10pt
+        }
+
+        .c19 {
+            font-size: 11pt
+        }
+
+        .terms .title {
+            padding-top: 0pt;
+            color: #000000;
+            font-size: 26pt;
+            padding-bottom: 3pt;
+            font-family: "Arial";
+            line-height: 1.15;
+            page-break-after: avoid;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .terms .subtitle {
+            padding-top: 0pt;
+            color: #666666;
+            font-size: 15pt;
+            padding-bottom: 16pt;
+            font-family: "Arial";
+            line-height: 1.15;
+            page-break-after: avoid;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .terms li {
+            color: #000000;
+            font-size: 11pt;
+            font-family: "Arial"
+        }
+
+        .terms p {
+            margin: 0;
+            color: #000000;
+            font-size: 11pt;
+            font-family: "Arial"
+        }
+
+        .terms h1 {
+            padding-top: 20pt;
+            color: #000000;
+            font-size: 20pt;
+            padding-bottom: 6pt;
+            font-family: "Arial";
+            line-height: 1.15;
+            page-break-after: avoid;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .terms h2 {
+            padding-top: 18pt;
+            color: #000000;
+            font-size: 16pt;
+            padding-bottom: 6pt;
+            font-family: "Arial";
+            line-height: 1.15;
+            page-break-after: avoid;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .terms h3 {
+            padding-top: 16pt;
+            color: #434343;
+            font-size: 14pt;
+            padding-bottom: 4pt;
+            font-family: "Arial";
+            line-height: 1.15;
+            page-break-after: avoid;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .terms h4 {
+            padding-top: 14pt;
+            color: #666666;
+            font-size: 12pt;
+            padding-bottom: 4pt;
+            font-family: "Arial";
+            line-height: 1.15;
+            page-break-after: avoid;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .terms h5 {
+            padding-top: 12pt;
+            color: #666666;
+            font-size: 11pt;
+            padding-bottom: 4pt;
+            font-family: "Arial";
+            line-height: 1.15;
+            page-break-after: avoid;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+
+        .terms h6 {
+            padding-top: 12pt;
+            color: #666666;
+            font-size: 11pt;
+            padding-bottom: 4pt;
+            font-family: "Arial";
+            line-height: 1.15;
+            page-break-after: avoid;
+            font-style: italic;
+            orphans: 2;
+            widows: 2;
+            text-align: left
+        }
+    </style>
+
+    <script>
+        $(document).ready(function () {
+            tickEvent = function (id, data) {
+                if (!pxt.aiTrackEvent) return;
+                if (!data) pxt.aiTrackEvent(id);
+                else {
+                    var props = {};
+                    var measures = {};
+                    for (var k in data)
+                        if (typeof data[k] == "string") props[k] = data[k];
+                        else measures[k] = data[k];
+                    pxt.aiTrackEvent(id, props, measures);
+                }
+            }
+        });
+        function agreeCheckboxChanged() {
+            var downloadSegment = document.getElementById("download-segment");
+            downloadSegment.classList.toggle("hidden");
+        }
+        function downloadWin64() {
+            // TODO: Keep this link up-to-date with the desired release version
+            window.open("https://makecode.com/api/release/ev3/v1.2.22/win64");
+            tickEvent("offlineapp.download", { "target": "ev3", "platform": "win64" });
+        }
+        function downloadMac64() {
+            // TODO: Keep this link up-to-date with the desired release version
+            window.open("https://makecode.com/api/release/ev3/v1.2.22/mac64");
+            tickEvent("offlineapp.download", { "target": "ev3", "platform": "mac64" });
+        }
+    </script>
+
+</head>
+
+<body id="root" class="root">
+
+    <div class="ui inverted vertical center aligned segment content">
+
+        <div class="ui grid topbar">
+            <div class="three wide column">
+                <img class="ui small image left" src="/static//lego_education_logo_white.png" />
+            </div>
+            <div class="ten wide column">
+                <h1 class="ui inverted welcomeheader">MakeCode Offline App</h1>
+            </div>
+            <div class="three wide column">
+                <img class="ui small image right" src="/static//Microsoft-logo_rgb_c-white.png" />
+            </div>
+        </div>
+
+        <div class="ui compact segments terms-container">
+            <div class="ui secondary center aligned segment">
+                Please read and accept the following terms to download the app.
+            </div>
+            <div class="ui left aligned segment terms">
+                <div class="c17">
+                    <p class="c11">
+                        <span class="c4 c1">MICROSOFT PRE-RELEASE SOFTWARE LICENSE TERMS</span>
+                    </p>
+                    <p class="c11">
+                        <span class="c4 c1">MICROSOFT MAKECODE FOR LEGO MINDSTORMS EDUCATION EV3</span>
+                    </p>
+                    <p class="c7">
+                        <span class="c4 c1"></span>
+                    </p>
+                    <p class="c11">
+                        <span class="c3 c1">These license terms are an agreement between Microsoft Corporation (or based on where you live, one
+                            of its affiliates) and you. They apply to the software named above. The terms also apply to any
+                            Microsoft services or updates for the software, except to the extent those have additional terms.</span>
+                    </p>
+                    <p class="c7">
+                        <span class="c3 c1"></span>
+                    </p>
+                    <p class="c11">
+                        <span class="c4 c1">IF YOU COMPLY WITH THESE LICENSE TERMS, YOU HAVE THE RIGHTS BELOW.</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">1.</span>
+                        <span class="c1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>
+                        <span class="c5 c1">INSTALLATION AND USE RIGHTS. </span>
+                        <span class="c3 c1">You may install and use any number of copies of the software to evaluate it as you develop and test
+                            your software applications for use with Lego Mindstorms Education EV3 hardware.</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">2.</span>
+                        <span class="c1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>
+                        <span class="c5 c1">PRE-RELEASE SOFTWARE. </span>
+                        <span class="c3 c1">The software is a pre-release version. It may not work the way a final version of the software will.
+                            Microsoft may change it for the final, commercial version. We also may not release a commercial
+                            version. Microsoft is not obligated to provide maintenance, technical support or updates to you
+                            for the software.</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">3.</span>
+                        <span class="c1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>
+                        <span class="c5 c1">ASSOCIATED ONLINE SERVICES.</span>
+                        <span class="c1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Some features of the software provide access 
+                            to, or rely on, online services to provide you information about updates to the software or extensions, 
+                            or to enable you to retrieve content, collaborate with others, or otherwise supplement your development 
+                            experience.  As used throughout these license terms, the term <q>software</q> includes these online 
+                            services and features. By using these online services and features you consent to the to the 
+                            transmission of information as described in Section 5, DATA.
+                        </span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">4.</span>
+                        <span class="c1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>
+                        <span class="c5 c1">LICENSES FOR OTHER COMPONENTS.</span>
+                        <span class="c3 c1">&nbsp;The software may include third party components with separate legal notices or governed by
+                            other agreements, as described in the ThirdPartyNotices file accompanying the software. Even
+                            if such components are governed by other agreements, the disclaimers and the limitations on and
+                            exclusions of damages below also apply.</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">5.</span>
+                        <span class="c1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>
+                        <span class="c1 c4">DATA.</span>
+                    </p>
+                    <p class="c8">
+                        <span class="c5 c1">a.</span>
+                        <span class="c1">&nbsp; &nbsp;</span>
+                        <span class="c1 c5">Data Collection. </span>
+                        <span class="c1">The software may collect information about you and your use of the software, and send that to Microsoft.
+                            Microsoft may use this information to provide services and improve our products and services.
+                            You may opt out of many of these scenarios, but not all, as described in the product documentation.
+                            In using the software, you must comply with applicable law. You can learn more about data collection
+                            and use in the help documentation and the privacy statement at </span>
+                        <span class="c14 c1">
+                            <a class="c9" href="http://go.microsoft.com/fwlink/?LinkId=398505">http://go.microsoft.com/fwlink/?LinkId=398505</a>
+                        </span>
+                        <span class="c1">.</span>
+                        <span class="c3 c1">&nbsp;Your use of the software operates as your consent to these practices.</span>
+                    </p>
+                    <p class="c8">
+                        <span class="c5 c1">b.</span>
+                        <span class="c1">&nbsp; &nbsp;</span>
+                        <span class="c5 c1">Processing of Personal Data. </span>
+                        <span class="c1">To the extent Microsoft is a processor or subprocessor of personal data in connection with the software,
+                            Microsoft makes the commitments in the European Union General Data Protection Regulation Terms
+                            of the Online Services Terms to all customers effective May 25, 2018, at </span>
+                        <span class="c1 c14">
+                            <a class="c9" href="http://go.microsoft.com/?linkid=9840733">http://go.microsoft.com/?linkid=9840733</a>
+                        </span>
+                        <span class="c3 c1">.</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">6.</span>
+                        <span class="c1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>
+                        <span class="c5 c1">FEEDBACK. </span>
+                        <span class="c3 c1">If you give feedback about the software to Microsoft, you give to Microsoft, without charge, the
+                            right to use, share and commercialize your feedback in any way and for any purpose. You will
+                            not give feedback that is subject to a license that requires Microsoft to license its software
+                            or documentation to third parties because we include your feedback in them. These rights survive
+                            this agreement.</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">7.</span>
+                        <span class="c1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>
+                        <span class="c5 c1">SCOPE OF LICENSE.</span>
+                        <span class="c3 c1">&nbsp;The software is licensed, not sold. This agreement only gives you some rights to use the software.
+                            Microsoft reserves all other rights. Unless applicable law gives you more rights despite this
+                            limitation, you may use the software only as expressly permitted in this agreement. &nbsp;In
+                            doing so, you must comply with any technical limitations in the software that only allow you
+                            to use it in certain ways. You may not:</span>
+                    </p>
+                    <p class="c8">
+                        <span class="c3 c1">- &nbsp; &nbsp; work around any technical limitations in the software;</span>
+                    </p>
+                    <p class="c8">
+                        <span class="c3 c1">- &nbsp; &nbsp; reverse engineer, decompile or disassemble the software, or attempt to do so, except
+                            and only to the extent required by third party licensing terms governing use of certain open
+                            source components that may be included with the software;</span>
+                    </p>
+                    <p class="c8">
+                        <span class="c3 c1">- &nbsp; &nbsp; remove, minimize, block or modify any notices of Microsoft or its suppliers in the
+                            software;
+                        </span>
+                    </p>
+                    <p class="c8">
+                        <span class="c3 c1">- &nbsp; &nbsp; use the software in any way that is against the law; or</span>
+                    </p>
+                    <p class="c8">
+                        <span class="c3 c1">- &nbsp; &nbsp; share, publish, rent or lease the software, or provide the software as a stand-alone
+                            offering for others to use.</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">8. &nbsp; UPDATES. </span>
+                        <span class="c3 c1">The software may periodically check for updates and download and install them for you. You may obtain
+                            updates only from Microsoft or authorized sources. Microsoft may need to update your system to
+                            provide you with updates. You agree to receive these automatic updates without any additional
+                            notice. Updates may not include or support all existing software features, services, or peripheral
+                            devices.
+                        </span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">9.</span>
+                        <span class="c1">&nbsp; &nbsp;</span>
+                        <span class="c5 c1">EXPORT RESTRICTIONS.</span>
+                        <span class="c3 c1">&nbsp;You must comply with all domestic and international export laws and regulations that apply
+                            to the software, which include restrictions on destinations, end users and end use. For further
+                            information on export restrictions, visit (aka.ms/exporting).</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">10.</span>
+                        <span class="c1">&nbsp;</span>
+                        <span class="c5 c1">SUPPORT SERVICES. </span>
+                        <span class="c3 c1">Because the software is &ldquo;as is,&rdquo; we may not provide support services for it.</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">11.</span>
+                        <span class="c1">&nbsp;</span>
+                        <span class="c5 c1">ENTIRE AGREEMENT.</span>
+                        <span class="c3 c1">&nbsp;This agreement, and the terms for supplements, updates, Internet-based services and support
+                            services that you use, are the entire agreement for the software and support services.</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">12.</span>
+                        <span class="c1">&nbsp;</span>
+                        <span class="c5 c1">APPLICABLE LAW. </span>
+                        <span class="c3 c1">If you acquired the software in the United States, Washington State law applies to interpretation
+                            of and claims for breach of this agreement, and the laws of the state where you live apply to
+                            all other claims. If you acquired the software in any other country, its laws apply.</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">13.</span>
+                        <span class="c1">&nbsp;</span>
+                        <span class="c5 c1">CONSUMER RIGHTS; REGIONAL VARIATIONS. </span>
+                        <span class="c3 c1">This agreement describes certain legal rights. You may have other rights, including consumer rights,
+                            under the laws of your state or country. Separate and apart from your relationship with Microsoft,
+                            you may also have rights with respect to the party from which you acquired the software. This
+                            agreement does not change those other rights if the laws of your state or country do not permit
+                            it to do so. For example, if you acquired the software in one of the below regions, or mandatory
+                            country law applies, then the following provisions apply to you:</span>
+                    </p>
+                    <p class="c8">
+                        <span class="c5 c1">a.</span>
+                        <span class="c1">&nbsp; &nbsp;</span>
+                        <span class="c5 c1">Australia. </span>
+                        <span class="c3 c1">You have statutory guarantees under the Australian Consumer Law and nothing in this agreement is
+                            intended to affect those rights.</span>
+                    </p>
+                    <p class="c8">
+                        <span class="c5 c1">b.</span>
+                        <span class="c1">&nbsp; &nbsp;</span>
+                        <span class="c5 c1">Canada. </span>
+                        <span class="c3 c1">If you acquired the software in Canada, you may stop receiving updates by turning off the automatic
+                            update feature, disconnecting your device from the Internet (if and when you re-connect to the
+                            Internet, however, the software will resume checking for and installing updates), or uninstalling
+                            the software. The product documentation, if any, may also specify how to turn off updates for
+                            your specific device or software.</span>
+                    </p>
+                    <p class="c8">
+                        <span class="c5 c1">c.</span>
+                        <span class="c1">&nbsp; &nbsp;</span>
+                        <span class="c5 c1">Germany and Austria</span>
+                        <span class="c3 c1">.</span>
+                    </p>
+                    <p class="c6">
+                        <span class="c5 c1">(i)</span>
+                        <span class="c1">&nbsp; &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>
+                        <span class="c5 c1">Warranty</span>
+                        <span class="c3 c1">. The properly licensed software will perform substantially as described in any Microsoft materials
+                            that accompany the software. However, Microsoft gives no contractual guarantee in relation to
+                            the licensed software.</span>
+                    </p>
+                    <p class="c6">
+                        <span class="c4 c1">&nbsp;</span>
+                    </p>
+                    <p class="c6">
+                        <span class="c5 c1">(ii)</span>
+                        <span class="c1">&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>
+                        <span class="c5 c1">Limitation of Liability</span>
+                        <span class="c3 c1">. In case of intentional conduct, gross negligence, claims based on the Product Liability Act, as
+                            well as, in case of death or personal or physical injury, Microsoft is liable according to the
+                            statutory law.</span>
+                    </p>
+                    <p class="c10">
+                        <span class="c3 c1">Subject to the foregoing clause (ii), Microsoft will only be liable for slight negligence if Microsoft
+                            is in breach of such material contractual obligations, the fulfillment of which facilitate the
+                            due performance of this agreement, the breach of which would endanger the purpose of this agreement
+                            and the compliance with which a party may constantly trust in (so-called &quot;cardinal obligations&quot;).
+                            In other cases of slight negligence, Microsoft will not be liable for slight negligence.</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">14.</span>
+                        <span class="c1">&nbsp;</span>
+                        <span class="c5 c1">LEGAL EFFECT.</span>
+                        <span class="c3 c1">&nbsp;This agreement describes certain legal rights. You may have other rights under the laws of
+                            your country. You may also have rights with respect to the party from whom you acquired the software.
+                            This agreement does not change your rights under the laws of your country if the laws of your
+                            country do not permit it to do so.</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">15.</span>
+                        <span class="c1">&nbsp;</span>
+                        <span class="c4 c1">DISCLAIMER OF WARRANTY. THE SOFTWARE IS LICENSED &ldquo;AS-IS.&rdquo; &nbsp;YOU BEAR THE RISK OF
+                            USING IT. MICROSOFT GIVES NO EXPRESS WARRANTIES, GUARANTEES OR CONDITIONS. TO THE EXTENT PERMITTED
+                            UNDER YOUR LOCAL LAWS, MICROSOFT EXCLUDES THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS
+                            FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c5 c1">16.</span>
+                        <span class="c1">&nbsp;</span>
+                        <span class="c4 c1">LIMITATION ON AND EXCLUSION OF DAMAGES. YOU CAN RECOVER FROM MICROSOFT AND ITS SUPPLIERS ONLY DIRECT
+                            DAMAGES UP TO U.S. $5.00. YOU CANNOT RECOVER ANY OTHER DAMAGES, INCLUDING CONSEQUENTIAL, LOST
+                            PROFITS, SPECIAL, INDIRECT OR INCIDENTAL DAMAGES.</span>
+                    </p>
+                    <p class="c0">
+                        <span class="c3 c1">This limitation applies to (a) anything related to the software, services, content (including code)
+                            on third party Internet sites, or third party programs; and (b) claims for breach of contract,
+                            breach of warranty, guarantee or condition, strict liability, negligence, or other tort to the
+                            extent permitted by applicable law.</span>
+                    </p>
+                    <p class="c0">
+                        <span class="c3 c1">It also applies even if Microsoft knew or should have known about the possibility of the damages.
+                            The above limitation or exclusion may not apply to you because your country may not allow the
+                            exclusion or limitation of incidental, consequential or other damages.</span>
+                    </p>
+                    <p class="c12">
+                        <span class="c4 c1">Please note: As the software is distributed in Quebec, Canada, some of the clauses in this agreement
+                            are provided below in French.</span>
+                    </p>
+                    <p class="c12">
+                        <span class="c4 c1">Remarque : Ce logiciel &eacute;tant distribu&eacute; au Qu&eacute;bec, Canada, certaines des clauses
+                            dans ce contrat sont fournies ci-dessous en fran&ccedil;ais.</span>
+                    </p>
+                    <p class="c11">
+                        <span class="c5 c1">EXON&Eacute;RATION DE GARANTIE.</span>
+                        <span class="c1 c3">&nbsp;Le logiciel vis&eacute; par une licence est offert &laquo; tel quel &raquo;. Toute utilisation
+                            de ce logiciel est &agrave; votre seule risque et p&eacute;ril. Microsoft n&rsquo;accorde aucune
+                            autre garantie expresse. Vous pouvez b&eacute;n&eacute;ficier de droits additionnels en vertu
+                            du droit local sur la protection des consommateurs, que ce contrat ne peut modifier. La ou elles
+                            sont permises par le droit locale, les garanties implicites de qualit&eacute; marchande, d&rsquo;ad&eacute;quation
+                            &agrave; un usage particulier et d&rsquo;absence de contrefa&ccedil;on sont exclues.
+                        </span>
+                    </p>
+                    <p class="c11">
+                        <span class="c5 c1">LIMITATION DES DOMMAGES-INT&Eacute;R&Ecirc;TS ET EXCLUSION DE RESPONSABILIT&Eacute; POUR LES DOMMAGES.</span>
+                        <span class="c3 c1">&nbsp;Vous pouvez obtenir de Microsoft et de ses fournisseurs une indemnisation en cas de dommages
+                            directs uniquement &agrave; hauteur de 5,00 $ US. Vous ne pouvez pr&eacute;tendre &agrave; aucune
+                            indemnisation pour les autres dommages, y compris les dommages sp&eacute;ciaux, indirects ou
+                            accessoires et pertes de b&eacute;n&eacute;fices.</span>
+                    </p>
+                    <p class="c12">
+                        <span class="c3 c1">Cette limitation concerne :</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c3 c1">- &nbsp; &nbsp; &nbsp; &nbsp; tout ce qui est reli&eacute; au logiciel, aux services ou au contenu
+                            (y compris le code) figurant sur des sites Internet tiers ou dans des programmes tiers ; et</span>
+                    </p>
+                    <p class="c2">
+                        <span class="c3 c1">- &nbsp; &nbsp; &nbsp; &nbsp; les r&eacute;clamations au titre de violation de contrat ou de garantie,
+                            ou au titre de responsabilit&eacute; stricte, de n&eacute;gligence ou d&rsquo;une autre faute
+                            dans la limite autoris&eacute;e par la loi en vigueur.</span>
+                    </p>
+                    <p class="c12">
+                        <span class="c3 c1">Elle s&rsquo;applique &eacute;galement, m&ecirc;me si Microsoft connaissait ou devrait conna&icirc;tre
+                            l&rsquo;&eacute;ventualit&eacute; d&rsquo;un tel dommage. Si votre pays n&rsquo;autorise pas
+                            l&rsquo;exclusion ou la limitation de responsabilit&eacute; pour les dommages indirects, accessoires
+                            ou de quelque nature que ce soit, il se peut que la limitation ou l&rsquo;exclusion ci-dessus
+                            ne s&rsquo;appliquera pas &agrave; votre &eacute;gard.</span>
+                    </p>
+                    <p class="c16">
+                        <span class="c5 c1">EFFET JURIDIQUE.</span>
+                        <span class="c3 c1">&nbsp;Le pr&eacute;sent contrat d&eacute;crit certains droits juridiques. Vous pourriez avoir d&rsquo;autres
+                            droits pr&eacute;vus par les lois de votre pays. Le pr&eacute;sent contrat ne modifie pas les
+                            droits que vous conf&egrave;rent les lois de votre pays si celles-ci ne le permettent pas.</span>
+                    </p>
+                    <p class="c15">
+                        <span class="c3 c1"></span>
+                    </p>
+                    <p class="c16">
+                        <span class="c3 c1">&nbsp;</span>
+                    </p>
+                    <p class="c11">
+                        <span class="c3 c1">LEGO, the LEGO logo, MINDSTORMS and the MINDSTORMS EV3 logo are trademarks and/ or copyrights of
+                            the LEGO Group. &copy;2018 The LEGO Group. All rights reserved.</span>
+                    </p>
+                    <p class="c11">
+                        <span class="c3 c1">&nbsp;</span>
+                    </p>
+                    <p class="c20">
+                        <span class="c5 c1 c13">Remainder of this page intentionally left blank.</span>
+                    </p>
+                    <p class="c7">
+                        <span class="c3 c19"></span>
+                    </p>
+                </div>
+            </div>
+            <div class="ui center aligned segment">
+                <input id="agree-checkbox" type="checkbox" autocomplete="off" onchange="agreeCheckboxChanged(this)">
+                <label for="agree-checkbox">I agree to these Microsoft Software License Terms and to the
+                    <a href="https://privacy.microsoft.com/en-us/privacystatement">Microsoft Privacy Statement.</a>
+                </label>
+            </div>
+            <div id="download-segment" class="ui center aligned segment hidden">
+                <div class="ui grid">
+                    <div class="eight wide column">
+                        <h3 class="ui">Windows</h3>
+                        <button class="ui icon button" onclick="downloadWin64()">
+                            <i class="download icon"></i>
+                            makecode-ev3-setup-win64.exe
+                        </button>
+                    </div>
+                    <div class="eight wide column">
+                        <h3 class="ui">Mac OS</h3>
+                        <button class="ui icon button" onclick="downloadMac64()">
+                            <i class="download icon"></i>
+                            makecode-ev3-mac64.zip
+                        </button>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+    </div>
+
+    <!-- @include footer.html -->
+    <!-- @include tracking.html -->
+
+</body>
+
+</html>

docs/offline.md

@@ -0,0 +1,5 @@
+# @extends
+
+## Offline app #target-app
+
+The MakeCode editor is available as app which you can install on a computer with Windows or Mac OS. Once installed, the **[MakeCode Offline App](/offline-app)** lets you create, run, and download your projects to the @boardname@. It works the same as the Web application does in your browser but it's a stand-alone application that will work when a connection to the internet is restricted or not available.

docs/packages-ref.json

@@ -0,0 +1,3 @@
+{
+    "redirect": "/extensions"
+}

docs/packages/approval-ref.json

@@ -0,0 +1,3 @@
+{
+    "redirect": "https://makecode.com/extensions/approval"
+}

docs/packages/build-your-own-ref.json

@@ -0,0 +1,3 @@
+{
+    "redirect": "https://makecode.com/extensions/getting-started"
+}

docs/packages/versioning-ref.json

@@ -0,0 +1,3 @@
+{
+    "redirect": "https://makecode.com/extensions/versioning"
+}

docs/projects.md

@@ -4,6 +4,6 @@ Here are some cool projects that you can build with your @boardname@!
 
 ## Basic
 
-Basic projects to build with your @boardname@.
+Basic projects to build with your EV3 Brick.
 
 Coming soon.

docs/reference.md

@@ -1,6 +1,7 @@
 # Reference
 
 ```namespaces
+music.playSoundEffect(sounds.animalsCatPurr);
 sensors.color(null);
 motors.stopAll();
 brick.showMood(moods.sleeping);
@@ -18,5 +19,6 @@ control.runInParallel(function(){});
 [brick](/reference/brick),
 [sensors](/reference/sensors),
 [motors](/reference/motors),
+[music](/reference/music),
 [control](/reference/control),
 [console](/reference/console)

docs/reference/brick.md

@@ -9,6 +9,7 @@ brick.showString("Hello world!", 1);
 brick.showNumber(0, 1);
 brick.showValue("item", 0, 1);
 brick.clearScreen();
+brick.showPorts();
 ```
 
 ## Buttons
@@ -19,8 +20,8 @@ brick.buttonEnter.onEvent(ButtonEvent.Bumped, function () {
 });
 brick.buttonEnter.pauseUntil(ButtonEvent.Bumped);
 brick.buttonEnter.isPressed()
-brick.buttonEnter.wasPressed()
 brick.setStatusLight(StatusLight.Red);
+brick.buttonEnter.wasPressed()
 ```
 
 ## Other

docs/reference/brick/battery-property.md

@@ -0,0 +1,47 @@
+# battery Property
+
+Return the information about the battery
+
+```sig
+brick.batteryInfo(BatteryProperty.Level)
+```
+
+## Parameters
+
+* property: the kind of information
+
+## Returns
+
+* a [number](/types/number) which represents the value of the property requested.
+
+## Example
+
+Show the battery level percentage on the screen. Also, show a green light if the battery level is above 15%. If the battery level is below 15% but above 5%, show a orange light. But, if the battery level is below 5%, show a pulsing red light.
+
+```blocks
+let battery = 0;
+forever(function() {
+    brick.showString("Battery level:", 1)
+    brick.showNumber(battery, 2)
+    battery = brick.batteryInfo(BatteryProperty.Level);
+    if (battery > 15)
+    {
+        brick.setStatusLight(StatusLight.Green);
+    } else if (battery > 5) {
+        brick.setStatusLight(StatusLight.Orange);
+    } else {
+        brick.setStatusLight(StatusLight.RedPulse)
+    }
+    pause(30000)
+})
+```
+
+Or see all the values
+
+```blocks
+forever(function () {
+    brick.showValue("bat V", brick.batteryInfo(BatteryProperty.Voltage), 1)
+    brick.showValue("bat %", brick.batteryInfo(BatteryProperty.Level), 2)
+    brick.showValue("bat I", brick.batteryInfo(BatteryProperty.Current), 3)
+})
+```

docs/reference/brick/button/was-pressed.md

@@ -14,7 +14,7 @@ The fact that a button was pressed earlier is remembered. Once **was pressed** i
 
 Your @boardname@ has touch sensors that work like buttons. Instead of saying `enter` or `left` as the source button, use a touch sensor block with a sensor name like `touch 1`.
 
-```block
+```typescript
 if (sensors.touch1.wasPressed()) {
     console.log("Hey, I was pressed.");
 }
@@ -32,7 +32,7 @@ Read about [touch sensors](/reference/sensors/touch-sensor) and using them as to
 
 Set the brick light to green if the `right` button was pressed before the `left` button. If not, the brick light is turned off when the `left` button is pressed.
 
-```blocks
+```typescript
 brick.buttonLeft.onEvent(ButtonEvent.Bumped, function() {
     if (brick.buttonRight.wasPressed()) {
         brick.setStatusLight(StatusLight.Green)
@@ -45,6 +45,5 @@ brick.buttonLeft.onEvent(ButtonEvent.Bumped, function() {
 ## See also
 
 [is pressed](/reference/brick/button/is-pressed),
-[on event](/reference/brick/button/on-event)
-
+[on event](/reference/brick/button/on-event),
 [Touch sensors](/reference/sensors/touch-sensor)

docs/reference/brick/show-ports.md

@@ -0,0 +1,24 @@
+# show Ports
+
+Show the status of everything connected to the ports.
+
+```sig
+brick.showPorts()
+```
+
+You can find out what's connected to the ports on the brick and show its status. The status information from each sensor or motor connected is displayed on the screen.
+
+## Example
+
+Show the status of the ports on the brick. Resets all motors when ENTER is pressed.
+
+```blocks
+brick.showPorts()
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    motors.resetAll()
+})
+```
+
+## See also
+
+[show string](/reference/brick/show-string), [show value](/reference/brick/show-value)

docs/reference/console/send-to-screen.md

@@ -8,7 +8,7 @@ console.sendToScreen();
 
 A "console" is a place for a user to see special messages from a device. It could be  something connected to a serial port, a display that shows text, or even a text file. A console is typically used as a place to send information that is added to a message _log_ (a record of messages that are sent from a device). Your program can send log messages using the [console](/reference/console) functions. The MakeCode editor has a console view that lets you see the console output when your program runs in the simulator.
 
-On the @boardname@, the screen can serve as a console too and you can make your console output go there. Before using the console log functions, set the screen as the console output location.
+On the EV3 Brick, the screen can serve as a console too and you can make your console output go there. Before using the console log functions, set the screen as the console output location.
 
 ## Example
 

docs/reference/control/assert.md

@@ -0,0 +1,12 @@
+# @extends
+
+## Example #example
+
+Stop the program if the gyro dectects an angle greater than 45 degrees.
+
+```blocks
+forever(function () {
+    control.assert(sensors.gyro2.angle() > 45, 15)
+    pause(300)
+})
+```

docs/reference/control/device-serial-number.md

@@ -0,0 +1,9 @@
+# @extends
+
+## Example #example
+
+Log the device serial number to the console.
+
+```blocks
+console.logValue("serialnumber", control.deviceSerialNumber());
+```

docs/reference/control/on-event.md

@@ -0,0 +1,25 @@
+# @extends
+
+# Example #example
+
+Register two events coming from source `22`. Make the brick status light up  when
+the events of `0` and `1` are _raised_.
+
+```blocks
+const statusLighter = 22;
+
+control.runInParallel(() => {
+    for (let i = 0; i < 2; i++) {
+        pause(1000);
+        control.raiseEvent(statusLighter, i);
+    }
+})
+
+control.onEvent(statusLighter, 0, () => {
+    brick.setStatusLight(StatusLight.OrangePulse)
+})
+
+control.onEvent(statusLighter, 1, () => {
+    brick.setStatusLight(StatusLight.GreenPulse)
+})
+```

docs/reference/control/panic.md

@@ -0,0 +1,13 @@
+# @extends
+
+## Example #example
+
+Send a 'code red' error that you created to the error display if the brick crashes into a wall.
+
+```blocks
+let codeRed = 1
+let codeBlue = 2
+sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
+    control.panic(codeRed)	
+})
+```

docs/reference/control/raise-event.md

@@ -0,0 +1,25 @@
+# @extends
+
+# Example #example
+
+Register two events coming from source `22`. Make the brick status light up  when
+the events of `0` and `1` are _raised_.
+
+```blocks
+const statusLighter = 22;
+
+control.runInParallel(() => {
+    for (let i = 0; i < 2; i++) {
+        pause(1000);
+        control.raiseEvent(statusLighter, i);
+    }
+})
+
+control.onEvent(statusLighter, 0, () => {
+    brick.setStatusLight(StatusLight.OrangePulse)
+})
+
+control.onEvent(statusLighter, 1, () => {
+    brick.setStatusLight(StatusLight.GreenPulse)
+})
+```

docs/reference/control/run-in-parallel.md

@@ -0,0 +1,61 @@
+# @extends
+
+## Separate tasks #tasks
+
+As an example, you could have a small task that checks the battery level and gives a warning when it drops below 15 percent. This is placed inside a ``||control:run in parallel||`` block:
+
+```block
+let powerCheck = false;
+
+control.runInParallel(() => {
+    while (!powerCheck) {
+        if (brick.batteryLevel() <= 15) {
+            brick.setStatusLight(StatusLight.RedFlash)
+            powerCheck = true;
+        } else {
+            pause(5000);
+        }
+    }
+})
+```
+
+The code the main program just drives the brick in a constant pattern until the battery check in the parallel task says that the battery level is too low.
+
+```block
+let powerCheck = false;
+while (!powerCheck) {
+    motors.largeBC.tank(50, 50, 5, MoveUnit.Seconds)
+    motors.largeBC.steer(5, 50, 6, MoveUnit.Rotations)
+}
+motors.stopAll()
+```
+
+## #example
+
+Tank the brick in a pattern until the battery warning variable is set. Have a separate task check the battery level and set a warning variable when the level is below `5` percent.
+
+```blocks
+let powerCheck = false;
+
+control.runInParallel(() => {
+    while (!powerCheck) {
+        if (brick.batteryLevel() < 5) {
+            powerCheck = true;
+        } else {
+            pause(5000);
+        }
+    }
+})
+
+while (!powerCheck) {
+    motors.largeBC.tank(20, 20, 5, MoveUnit.Seconds)
+    motors.largeBC.steer(15, 20, 6, MoveUnit.Rotations)
+    motors.largeBC.tank(40, 40, 5, MoveUnit.Seconds)
+    motors.largeBC.steer(-10, 20, 3, MoveUnit.Rotations)
+}
+motors.stopAll()
+```
+
+## See also #seealso
+
+[forever](/reference/loops/forever)

docs/reference/control/wait-micros.md

@@ -0,0 +1,17 @@
+# @extends
+
+## Example #example
+
+Use the a wait and the timer to generate a crazy number.
+
+```blocks
+let crazy = 0
+for (let i = 0; i < 100; i++) {
+    control.waitMicros(100)
+    crazy = control.millis()
+    crazy += control.deviceSerialNumber()
+    if (crazy != 0) {
+        crazy = crazy / 1000000
+    }
+}
+```

docs/reference/motors.md

@@ -19,6 +19,5 @@ motors.stopAll()
 ```cards
 motors.largeA.speed()
 motors.largeA.angle()
-motors.largeA.tacho()
 motors.largeA.clearCounts()
 ```

docs/reference/motors/motor/angle.md

@@ -27,5 +27,5 @@ motorAngle = motors.largeA.angle()
 
 ## See also
 
-[tacho](/reference/motors/motor/tacho), [speed](/reference/motors/motor/speed),
+[speed](/reference/motors/motor/speed),
 [reset](/reference/motors/motor/reset), [clear counts](/reference/motors/motor/clear-counts)

docs/reference/motors/motor/clear-counts.md

@@ -17,11 +17,11 @@ let tachoCount = 0;
 motors.largeA.reset()
 motors.largeA.run(50)
 pause(10000)
-tachoCount = motors.largeA.tacho()
+tachoCount = motors.largeA.angle()
 motors.largeA.clearCounts()
 motors.largeA.run(50)
 pause(10000)
-if (tachoCount == motors.largeA.tacho()) {
+if (tachoCount == motors.largeA.angle()) {
     brick.showString("Motor turns equal.", 1)
 } else {
     brick.showString("Motor turns NOT equal.", 1)
@@ -31,5 +31,5 @@ motors.largeA.stop()
 
 ## See also
 
-[tacho](/reference/motors/motor/tacho), [angle](/reference/motors/motor/angle),
+[angle](/reference/motors/motor/angle),
 [speed](/reference/motors/motor/speed), [reset](/reference/motors/motor/reset)

docs/reference/motors/motor/ramp.md

@@ -0,0 +1,59 @@
+# Ramp
+
+Schedules an acceleration, constant and deceleration phase at a given speed.
+
+```sig
+motors.largeA.ramp(50, 100, 500, 100)
+```
+
+The speed setting is a percentage of the motor's full speed. Full speed is the speed that the motor runs when the brick supplies maximum output voltage to the port.
+
+
+## Parameters
+
+* **speed**: a [number](/types/number) that is the percentage of full speed. A negative value runs the motor in the reverse direction.
+* **acceleration**: the [number](/types/number) of movement units to rotate for while accelerating.
+* **value**: the [number](/types/number) of movement units to rotate for.
+* **deceleration**: the [number](/types/number) of movement units to rotate for while decelerating.
+* **unit**: the movement unit of rotation. This can be `milliseconds`, `seconds`, `degrees`, or `rotations`. If the number for **value** is `0`, this parameter isn't used.
+
+## Example
+
+This is an interactive program that lets you change the values of 
+the acceleration and deceleration and see the effects.
+
+```blocks
+let steady = 0
+let dec = 0
+let acc = 0
+brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
+    acc += -100
+})
+brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeB.ramp(50, steady, MoveUnit.MilliSeconds, acc, dec)
+})
+brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
+    acc += 100
+})
+brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
+    dec += 100
+})
+brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
+    dec += -100
+})
+acc = 500
+steady = 1000
+acc = 500
+forever(function () {
+    brick.showValue("acc", acc, 1)
+    brick.showValue("steady", steady, 2)
+    brick.showValue("dec", dec, 3)
+    brick.showString("acc: left/right", 5)
+    brick.showString("dec: up/down", 6)
+    brick.showString("run large B: enter", 7)
+})
+```
+
+## See also
+
+[tank](/reference/motors/synced/tank), [steer](/reference/motors/synced/steer), [stop](/reference/motors/motor/stop)

docs/reference/motors/motor/run.md

@@ -6,9 +6,9 @@ Set the rotation speed of the motor as a percentage of maximum speed.
 motors.largeA.run(50)
 ```
 
-The speed setting is a pecentage of the motor's full speed. Full speed is the speed that the motor runs when the brick supplies maximum output voltage to the port.
+The speed setting is a percentage of the motor's full speed. Full speed is the speed that the motor runs when the brick supplies maximum output voltage to the port.
 
-If you use just the **speed** number, the motor runs continously and won't stop unless you tell it to. You can also give a value for a certain amount of distance you want the motor to rotate for. The **value** can be an amount of time, a turn angle in degrees, or a number of full rotations.
+If you use just the **speed** number, the motor runs continuously and won't stop unless you tell it to. You can also give a value for a certain amount of distance you want the motor to rotate for. The **value** can be an amount of time, a turn angle in degrees, or a number of full rotations.
 
 If you decide to use a **value** of rotation distance, you need to choose a type of movement **unit**.
 
@@ -30,8 +30,8 @@ Here is how you use each different movement unit to run the motor for a fixed ro
 // Run motor for 700 Milliseconds. 
 motors.largeA.run(25, 700, MoveUnit.MilliSeconds);
 
-// Run motor for 700 Milliseconds again but no units specified. 
-motors.largeA.run(25, 700);
+// Run motors B and C for 700 Milliseconds again but no units specified. 
+motors.largeBC.run(25, 700);
 
 // Run the motor for 45 seconds
 motors.largeA.run(50, 45, MoveUnit.Seconds);
@@ -61,6 +61,14 @@ motors.largeB.run(-25)
 
 ## ~
 
+## Multiple motors
+
+When using **run** with multiple motors, there is no guarantee that their speed will stay in sync. Use [tank](/reference/motors/tank) or [steer](/reference/motors/steer) for synchronized motor operations.
+
+```blocks
+motors.largeBC.run(50)
+```
+
 ## Examples
 
 ### Drive the motor for 20 seconds

docs/reference/motors/motor/set-brake-settle-time.md

@@ -0,0 +1,30 @@
+# set Brake Settle Time
+
+Set the time to wait after a motor stopped to allow it settle
+when brake is enabled. Default is 10ms.
+
+```sig
+motors.largeA.setBrakeSettleTime(200)
+```
+
+When a the motor is stopped and brake is applied, it can still wiggle for a little while. You can use the settle time to automatically way after stopping and let the robot settle.
+
+## Parameters
+
+* **time**: a [number](/types/number) value which represents the number of milliseconds to wait after braking.
+
+## Example
+
+Set the brake mode and the settle time to 500ms. Run the motor connected to port **A** for 2 seconds at a speed of `30` and stop after 2s.
+
+```blocks
+motors.largeA.setBrake(true)
+motors.largeA.setBrakeSettleTime(500)
+motors.largeA.run(30)
+pause(2000)
+motors.largeA.stop()
+```
+
+## See also
+
+[stop](/reference/motors/motor/stop)

docs/reference/motors/motor/set-brake.md

@@ -1,28 +1,28 @@
 # set Brake
 
-Set the brake on the motor so it won't turn when it has no power.
+Set the brake on the motor so it will brake when it finishes a brake command.
 
 ```sig
 motors.largeA.setBrake(false)
 ```
 
-When a the motor is stopped, it can still rotate if an external force is applied to it. This can happen, for example, if your're tanking your brick on a inclined surface and stop the motors. Gravity will push down on the brick and might cause it to start rolling again. You can prevent this movement by setting the brake.
+When a the motor is stopped, it can still rotate if an external force is applied to it. This can happen, for example, if you're tanking your brick on a inclined surface and stop the motors. Gravity will push down on the brick and might cause it to start rolling again. You can prevent this movement by setting the brake.
 
 Also, you can use the brake to do simple skid steering for your brick.
 
-## Paramters
+## Parameters
 
 * **brake**: a [boolean](/types/boolean) value which is either `true` to set the brake on or `false` to set the brake off.
 
 ## Example
 
-Run the motor connected to port **A** for 2 seconds at a speed of `30`. Stop and set the brake.
+Run the motor connected to port **A** for 2 seconds at a speed of `30` and stop after 2s.
 
 ```blocks
+motors.largeA.setBrake(true)
 motors.largeA.run(30)
 pause(2000)
 motors.largeA.stop()
-motors.largeA.setBrake(true)
 ```
 
 ## See also

docs/reference/motors/motor/set-run-phase.md

@@ -0,0 +1,26 @@
+# Set Run Phase
+
+Allows to specify an acceleration or deceleration phases for run commands.
+
+```sig
+motors.largeD.setRunPhase(MovePhase.Acceleration, 1, MoveUnit.Seconds)
+```
+
+Once the run phase is specified on a motor (or pair of motors),
+it will be automatically applied to [run](/reference/motors/run) commands.
+
+## Time vs Rotation
+
+The phases specified for time units (seconds, milliseconds) only apply to run with time
+moves. Similarly, the phases specified for rotation units (# rotation, degrees) only
+apply to run with rotation units.
+
+## Examples
+
+```blocks
+motors.largeB.setRunPhase(MovePhase.Acceleration, 0.5, MoveUnit.Seconds)
+motors.largeB.setRunPhase(MovePhase.Deceleration, 0.2, MoveUnit.Seconds)
+forever(function () {
+    motors.largeB.run(50, 1, MoveUnit.Seconds)
+})
+```

docs/reference/motors/motor/speed.md

@@ -29,5 +29,5 @@ motors.largeA.stop()
 
 ## See also
 
-[tacho](/reference/motors/motor/tacho), [speed](/reference/motors/motor/speed),
+[speed](/reference/motors/motor/speed),
 [reset](/reference/motors/motor/reset), [clear counts](/reference/motors/motor/clear-counts)

docs/reference/motors/motor/tacho.md

@@ -1,48 +0,0 @@
-# tacho
-
-Get the current number of degress of rotation.
-
-```sig
-motors.largeA.tacho()
-```
-
-The motors that come with your @boardname@ have a way to detect their own turning motion. They count the amount of motor rotation in degrees. The motor will count each degree of angle rotation up to 360 degrees for a full rotation. As the motor continues to turn, the _tacho_ count keeps adding up the degrees even past one full rotation. So, if the motor makes 3 complete rotations, the count will be 1080.
-
-The name _tacho_ comes from the first part of the word [tachometer](https://en.wikipedia.org/wiki/Tachometer) which is a device to measure how fast something is turning. The motor controller in the brick uses the tacho count to regulate the motor's speed.
-
-## ~hint
-
-**Measure RPM**
-
-A standard way to know how fast a motor is turning is by measuring its _revolutions per minute_ (rpm). One revolution is the same thing as a rotation, or one turn. How do you measure rpm? Well, here's a simple way:
-
-1. Record the current tacho count
-2. Run the motor for 60 seconds
-3. Get the tacho count again
-4. Subtract the first tacho count from the second one
-5. Divide that number by `360`
-
-## ~
-
-## Returns
-
-* a [number](/types/number) which is the total count of degrees of rotation that the motor has turned since it was first started or reset.
-
-## Example
-
-Run the motor connected to port **A** at half speed for 5 seconds. Display the number of full rotations on the screen.
-
-```blocks
-motors.largeA.run(50)
-pause(5000)
-motors.largeA.stop()
-brick.showString("Motor rotations:", 1)
-brick.showNumber(motors.largeA.tacho() / 360, 3)
-motors.largeA.run(50)
-```
-
-## See also
-
-[angle](/reference/motors/motor/tacho), [speed](/reference/motors/motor/speed),
-[set regulated](/reference/motors/motor/set-regulated),
-[reset](/reference/motors/motor/reset), [clear counts](/reference/motors/motor/clear-counts)

docs/reference/motors/reset-all.md

@@ -0,0 +1,25 @@
+# reset All Motors
+
+Reset all motors currently running on the brick.
+
+```sig
+motors.resetAll();
+```
+
+The motors counters are resetted. 
+
+## Example
+
+Tank the EV3 Brick forward at half speed for 5 seconds and then stop.
+
+```blocks
+motors.largeAB.tank(50, 50);
+pause(5000);
+motors.stopAll();
+motors.resetAll();
+```
+
+## See also
+
+[stop all](/reference/motors/motor/stop-all), 
+[reset](/reference/motors/motor/reset)

docs/reference/motors/stop-all.md

@@ -10,7 +10,7 @@ The motors stops but any motion caused from previously running the motors contin
 
 ## Example
 
-Tank the @boardname@ forward at half speed for 5 seconds and then stop.
+Tank the EV3 Brick forward at half speed for 5 seconds and then stop.
 
 ```blocks
 motors.largeAB.tank(50, 50);
@@ -22,4 +22,5 @@ motors.stopAll();
 
 [stop](/reference/motors/motor/stop), 
 [reset](/reference/motors/motor/reset),
+[reset-all](/reference/motors/motor/reset-all),
 [set brake](/reference/motors/motor/set-brake)

docs/reference/motors/synced/steer.md

@@ -8,7 +8,7 @@ motors.largeAB.steer(0, 0)
 
 A brick driving with two motors can steer itself by changing the speed of one motor compared to the speed of the other. To make a slow turn to the left, you might make the right motor run slightly faster than the left one. To make a fast, or sharp, turn to the right, the left motor could run at least twice as fast as the right one.
 
-The @boardname@ steers by using a percentage value of _follow_ for one of the motors. This means that the motor in the turn direction will rotate slower than the other. It is the _follower_ motor and the other motor is the _drive_ motor. The drive motor runs at a percentage of full speed set in **speed**. The follower motor runs at a percentage of speed of the drive motor. So, it runs at a percentage of a percentage of full speed.
+The EV3 Brick steers by using a percentage value of _follow_ for one of the motors. This means that the motor in the turn direction will rotate slower than the other. It is the _follower_ motor and the other motor is the _drive_ motor. The drive motor runs at a percentage of full speed set in **speed**. The follower motor runs at a percentage of speed of the drive motor. So, it runs at a percentage of a percentage of full speed.
 
 To make the turn happen you give a _turn ratio_ which is a percentage value of steer to the left or right. If you want to steer to the left at 30% of the of the drive motor speed, use the value of `-30` for **turnRatio**. Left turns use negative values and right turns use positive values. A really sharp turn to the right might use a turn ratio value of `80`.
 
@@ -22,7 +22,7 @@ If you decide to use a **value** of rotation distance, you need to choose a type
 
 ## Parameters
 
-* **turnRatio**: a [number](/types/number) that is the percentage of speed of the drive motor. The follower motor runs at this speed. A negative number steers to the left and a positive number steers to the right. This is a number between `-100` and `100`.
+* **turnRatio**: a [number](/types/number) that is the percentage of speed of the drive motor. The follower motor runs at this speed. A negative number steers to the left and a positive number steers to the right. This is a number between `-200` and `200`.
 * **speed**: a [number](/types/number) that is the percentage of full speed. A negative value runs the motors in the reverse direction. This is the speed that the drive motor runs at.
 * **value**: the [number](/types/number) of movement units to rotate for. A value of `0` means run the motor continuously.
 * **unit**: the movement unit of rotation. This can be `milliseconds`, `seconds`, `degrees`, or `rotations`. If the number for **value** is `0`, this parameter isn't used.
@@ -39,6 +39,13 @@ motors.largeBC.steer(-15, -75)
 
 ## ~
 
+## ~ hint
+
+Only one set of synchronized motors will run at the same time. Once you launch tank/steer, it will cancel any existing synchronized speed command.
+
+## ~
+
+
 ## Examples
 
 ### Make a slight right
@@ -79,6 +86,51 @@ for (let i = 0; i < 4; i++) {
 motors.stopAll()
 ```
 
+### Steer tester
+
+This program lets you change the values of speed and turn ratio with the buttons.
+
+```typescript
+let speed = 0;
+let turnRatio = 0;
+
+brick.showString(`steer tester`, 1)
+brick.showString(`connect motors BC`, 7)
+brick.showString(`up/down for speed`, 8)
+brick.showString(`left/right for turn ratio`, 9)
+
+forever(function () {
+    brick.showString(`motor B speed ${motors.largeB.speed()}%`, 4)
+    brick.showString(`motor C speed ${motors.largeC.speed()}%`, 5)
+    pause(100)
+})
+
+function updateSteer() {
+    motors.largeBC.steer(turnRatio, speed);
+    brick.showString(`speed ${speed}%`, 2)
+    brick.showString(`turnRatio ${turnRatio}`, 3)
+}
+
+brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
+    speed += 10
+    updateSteer()
+})
+brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
+    speed -= 10
+    updateSteer()
+})
+brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
+    turnRatio -= 10
+    updateSteer()
+})
+brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
+    turnRatio += 10
+    updateSteer()
+})
+
+updateSteer()
+```
+
 ## See also
 
 [tank](/reference/motors/synced/tank), [run](/reference/motors/motor/run)

docs/reference/motors/synced/tank.md

@@ -35,6 +35,12 @@ motors.largeBC.tank(-75, -75)
 
 ## ~
 
+## ~ hint
+
+Only one set of synchronized motors will run at the same time. Once you launch tank/steer, it will cancel any existing synchronized speed command.
+
+## ~
+
 ## Examples
 
 ### Tank forward and backward
@@ -76,6 +82,51 @@ pause(5000)
 motors.stopAll()
 ```
 
+### Tank tester
+
+This program lets you change the tank values using the brick buttons.
+
+```typescript
+let tankB = 0;
+let tankC = 0;
+
+brick.showString(`tank tester`, 1)
+brick.showString(`connect motors BC`, 7)
+brick.showString(`up/down for tank B`, 8)
+brick.showString(`left/right for tank C`, 9)
+
+forever(function () {
+    brick.showString(`motor B speed ${motors.largeB.speed()}%`, 4)
+    brick.showString(`motor C speed ${motors.largeC.speed()}%`, 5)
+    pause(100)
+})
+
+function updateTank() {
+    brick.showString(`tank A: ${tankB}%`, 2)
+    brick.showString(`tank B: ${tankC}%`, 3)
+    motors.largeBC.tank(tankB, tankC);
+}
+
+brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
+    tankB += 10
+    updateTank();
+})
+brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
+    tankB -= 10
+    updateTank();
+})
+brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
+    tankC += 10
+    updateTank();
+})
+brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
+    tankC -= 10
+    updateTank();
+})
+
+updateTank();
+```
+
 ## See also
 
 [steer](/reference/motors/synced/steer), [run](/reference/motors/motor/run)

docs/reference/music/ring-tone.md

@@ -0,0 +1,11 @@
+# @extends
+
+## Example #example
+
+This program checks the speed from the large `A` motor and uses the speed to adjust a tone it rings.
+
+```blocks
+loops.forever(function () {
+    music.ringTone(motors.largeA.speed() * 100)
+})
+```

docs/reference/music/set-volume.md

@@ -0,0 +1,10 @@
+# @extends
+
+## Example #example
+
+Play a tyrannosaurus roar at half volume.
+
+```blocks
+music.setVolume(50)
+music.playSoundEffect(sounds.animalsTRexRoar)
+```

docs/reference/music/stop-all-sounds.md

@@ -0,0 +1,10 @@
+# @extends
+
+## Example #example
+
+Play a sound effect but stop it right away.
+
+```blocks
+music.playSoundEffect(sounds.expressionsCrying)
+music.stopAllSounds()
+```

docs/reference/sensors.md

@@ -4,9 +4,9 @@
 
 ```cards
 sensors.color1.onColorDetected(ColorSensorColor.Blue, function () {})
-sensors.color1.onLightChanged(LightIntensityMode.Reflected, LightCondition.Dark, function () {})
-sensors.color1.pauseForLight(LightIntensityMode.Reflected, LightCondition.Dark)
-sensors.color1.pauseForColor(ColorSensorColor.Blue)
+sensors.color1.onLightDetected(LightIntensityMode.Reflected, Light.Dark, function () {})
+sensors.color1.pauseUntilLightDetected(LightIntensityMode.Reflected, Light.Dark)
+sensors.color1.pauseUntilColorDetected(ColorSensorColor.Blue)
 sensors.color1.color();
 sensors.color1.light(LightIntensityMode.Ambient)
 sensors.color(ColorSensorColor.Blue)
@@ -17,8 +17,8 @@ sensors.color(ColorSensorColor.Blue)
 ```cards
 sensors.touch1.onEvent(ButtonEvent.Pressed, function () {})
 sensors.touch1.pauseUntil(ButtonEvent.Pressed)
-sensors.touch1.wasPressed()
 sensors.touch1.isPressed()
+sensors.touch1.wasPressed()
 ```
 
 ## Gyro