Merge branch 'master' of https://github.com/Microsoft/kindscript-microbit

docs/about.md

@@ -0,0 +1,61 @@
+# About
+
+The [BBC micro:bit](https://www.microbit.co.uk) is a [pocket-size computer](/device) with 25 LEDs, Bluetooth and sensors that can be programmed by anyone.
+The BBC micro:bit was made possible by [a number of partners!](https://www.microbit.co.uk/partners)
+
+The micro:bit provides a fun introduction to programming and making – switch on, program it to do something fun – wear it, customize it.
+Just like Arduino, the micro:bit can be connected to and interact with sensors, displays, and other devices. 
+
+## Block Editor or JavaScript
+
+The student can program the BBC micro:bit using a Block Editor or JavaScript.
+
+```blocks
+basic.showString("BBC micro:bit!");
+```
+
+## Compile and Flash
+
+When a user has her code ready, she can connect her BBC micro:bit to a computer via a USB cable, so it appears as a mounted drive.
+
+Compilation to the ARM thumb machine code happens in the browser.
+
+The student is prompted to save the ARM binary program to a file, which she then simply drags to the micro:bit mounted drive, 
+which flashes the micro:bit device with the new program.
+
+## Simulator: Test Your Code
+Before a student compiles her code for the micro:bit, she can run it 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.
+
+```sim
+input.onButtonPressed(Button.A, () => {
+    basic.showLeds(`
+. . . . .
+. # . # .
+. . . . .
+# . . . #
+. # # # .`);
+});
+input.onGesture(Gesture.Shake, () => {
+    basic.showLeds(`
+. . . . .
+. # . # .
+. . . . .
+. # # # .
+# . . . #`);
+});
+``` 
+
+To run a student's project in the web browser, KindScript compiles it into JavaScript, the scripting language built into all web browsers.
+
+C++ and Touch Develop Libraries
+The C++ micro:bit library, created at Lancaster University, provides access to the hardware functions of the micro:bit, as well as a set of helper functions (such as displaying a number/image/string on the LED screen). The Touch Develop micro:bit library mirrors the functions of the C++ library. When a Touch Develop script is compiled to C++, the calls to Touch Develop micro:bit functions are replaced with calls to the corresponding C++ functions.
+
+Above, see the mapping from the Touch Develop "show number" function to its corresponding the C++ function.
+
+## C++ Runtime
+
+The C++ BBC micro:bit library, created at [Lancaster University](http://www.lancaster.ac.uk/), provides access to the hardware functions of the micro:bit, 
+as well as a set of helper functions (such as displaying a number/image/string on the LED screen). 
+The JavaScript micro:bit library mirrors the functions of the C++ library. 
+When code is compiled to C++, the calls to JavaScript micro:bit functions are replaced with calls to the corresponding C++ functions.

docs/device.md

@@ -1,6 +1,6 @@
-# Hardware
+# Device
 
-All the bits and pieces that make up your micro:bit
+All the bits and pieces that make up your BBC micro:bit
 
 ![](/static/mb/device-0.png)
 

docs/docs.md

@@ -3,5 +3,5 @@
 Welcome to the documentation.
 
 * Browse the [reference](/microbit/reference)
-* Learn more abou the [device](/microbit/device)
+* Learn more about the [device](/microbit/device)
 * Get started with [lessons](/microbit/lessons)

kindtheme.json

@@ -8,19 +8,10 @@
     "koduUrl": "https://www.kodugamelab.com/bbc-microbit/",
     "visualStudioCode": true,
     "docMenu": [
-      { "name": "About Us", "path": "/about" },
+      { "name": "About", "path": "/about" },
-      { "name": "Docs", "subitems": [ 
+      { "name": "Docs", "path": "/docs" },
-        { "name": "Basic", "path": "/reference/basic" },
+      { "name": "Lessons", "path": "/lessons" },
-        { "name": "Control", "path": "/reference/control" },
+      { "name": "Reference", "path": "/reference" },
-        { "name": "LEDs", "path": "/reference/control" },
+      { "name": "Device", "path": "/device" }
-        { "name": "Advanced", "subitems": [
-          { "name": "Serial", "path": "/reference/serial" },
-          { "name": "Debugging", "path": "/reference/debugging" }
-        ] },
-        { "name": "---" },
-        { "name": "Blocks", "path": "/reference/blocks" },
-        { "name": "JavaScript", "path": "/reference/js" }
-      ] },
-      { "name": "Lessons", "path": "/lessons" }
     ]
 }