From 5b682cd8d9907cd02b5575549a374bf7960c24fd Mon Sep 17 00:00:00 2001 From: Tom Ball Date: Thu, 14 Jul 2016 12:09:40 -0700 Subject: [PATCH] some mods to the docs --- docs/about.md | 16 +++++++--------- docs/device.md | 4 ++-- docs/getting-started.md | 2 +- 3 files changed, 10 insertions(+), 12 deletions(-) diff --git a/docs/about.md b/docs/about.md index 77c0b8fb..f330c5a5 100644 --- a/docs/about.md +++ b/docs/about.md @@ -35,7 +35,7 @@ Learn about about the [hardware components](/device) of the micro:bit to make th ## Programming: Blocks or JavaScript -The student can program the BBC micro:bit using [Blocks](/blocks) or [JavaScript](/javascript), via the [micro:bit APIs](/reference): +You can program the micro:bit using [Blocks](/blocks) or [JavaScript](/javascript), via the [micro:bit APIs](/reference): ```blocks basic.showString("Hi!"); @@ -43,21 +43,19 @@ basic.showString("Hi!"); ## Compile and Flash: Your Program! -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 (named MICROBIT). +When you have your code ready, you connect your micro:bit to a computer via a USB cable, so it appears as a mounted drive (named MICROBIT). -Compilation to ARM thumb machine code from [Blocks](/blocks) or [JavaScript](/javascript) 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. +Compilation to ARM thumb machine code from [Blocks](/blocks) or [JavaScript](/javascript) happens in the browser. You save the ARM binary +program to a file, which you then copy to the micro:bit 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. +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. ## C++ Runtime -The [C++ BBC micro:bit runtime](http://lancaster-university.github.io/microbit-docs/), created at [Lancaster University](http://www.lancaster.ac.uk/), provides access to the hardware functions of the micro:bit, +The [C++ micro:bit runtime](http://lancaster-university.github.io/microbit-docs/), 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 [micro:bit library](/reference) mirrors the functions of the C++ library. @@ -65,4 +63,4 @@ When code is compiled to ARM machine code, the calls to JavaScript micro:bit fun ## Open Source -The editor for the BBC micro:bit is [open source](/open-source) on GitHub. Contributors are welcome! +The code for the micro:bit is [open source](/open-source) on GitHub. Contributors are welcome! diff --git a/docs/device.md b/docs/device.md index b722d430..550f73be 100644 --- a/docs/device.md +++ b/docs/device.md @@ -1,6 +1,6 @@ # Device -All the bits and pieces that make up your BBC micro:bit +All the bits and pieces that make up the BBC micro:bit ![](/static/mb/device-0.png) @@ -77,7 +77,7 @@ You can attach an external device such as a motor to these and power it using th ### Serial Communication -The BBC micro:bit can send an receive data via [serial communication](/device/serial). The serial data can be transfered via USB or BLE. +The micro:bit can send an receive data via [serial communication](/device/serial). The serial data can be transfered via USB or BLE. ### Bluetooth Low Energy (BLE) Antenna diff --git a/docs/getting-started.md b/docs/getting-started.md index 1fe3577a..f00cd502 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -2,7 +2,7 @@ ## ~avatar -Are you ready to build cool BBC micro:bit programs? +Are you ready to build cool micro:bit programs? Here are some challenges for you. Arrange the blocks in the editor to make real programs that work!