added link to list of resellers

README.md

@@ -1,6 +1,6 @@
 # micro:bit target for PXT
 
-This target allow to program a [BBC micro:bit](https://www.microbit.co.uk/) using 
+This target allow to program a [BBC micro:bit](https://microbit.org/) using 
 PXT ([Microsoft Programming Experience Toolkit](https://github.com/Microsoft/pxt)).
 
 * [Try it live](https://pxt.microbit.org)

docs/about.md

@@ -4,8 +4,7 @@
 
 ### @description A Blocks / Javascript code editor for the micro:bit, a pocket-size computer with 5x5 display, sensors and Bluetooth.
 
-The [BBC micro:bit](https://www.microbit.co.uk) is a [pocket-size computer](/device) with a 5x5 display of 25 LEDs, Bluetooth and sensors that can be programmed by anyone.
+The [BBC micro:bit](https://microbit.org) is a [pocket-size computer](/device) with a 5x5 display of 25 LEDs, Bluetooth and sensors that can be programmed by anyone. The BBC micro:bit was made possible by many [partners](https://www.microbit.co.uk/partners).
-The BBC micro:bit was made possible by many [partners](https://www.microbit.co.uk/partners).
 
 The micro:bit provides an easy and 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. 
@@ -16,6 +15,12 @@ Just like Arduino, the micro:bit can be connected to and interact with sensors,
 
 The BBC micro:bit is packaged with sensors, radio and other goodies. Learn about the [hardware components](/device) of the micro:bit to make the most of it!
 
+### ~ hint
+
+**Looking to buy a micro:bit?** See the [list of resellers](https://microbit.org/resellers).
+
+### ~
+
 ## Programming: [Blocks](/blocks) or [JavaScript](/javascript)
 
 You can program the micro:bit using [Blocks](/blocks) or [JavaScript](/javascript) in your web browser via the [micro:bit APIs](/reference):

docs/device.md

@@ -1,9 +1,17 @@
 # Device
 
+
+### ~ hint
+
+**Looking to buy a micro:bit?** See the [list of resellers](https://microbit.org/resellers).
+
+### ~
+
 All the bits and pieces that make up the BBC micro:bit
 
 ![](/static/mb/device-0.png)
 
+
 ### LED Screen and Status LED
 
 The red lights are [LEDs](/device/screen) (light emitting diodes) and form a 5 x 5 LED Screen. 
@@ -23,19 +31,24 @@ When you have downloaded and run your code onto your micro:bit, press Button R t
 
 ### USB connection
 
-When you plug in your micro:bit, it should appear as ``MICROBIT``. 
+When you plug in your micro:bit via [USB](/device/usb), it should appear as  a ``MICROBIT`` drive. 
+
 If you accidentally hold down the reset button as you’re plugging in your micro:bit, 
-the micro:bit will appear as a MAINTENANCE drive instead of ``MICROBIT``. This is known as maintenance mode.**
+the micro:bit will appear as a MAINTENANCE drive instead of ``MICROBIT``. This is known as maintenance mode.
 
 To continue programming your micro:bit YOU MUST unplug your USB and reconnect it. Check that the drive now shows as ``MICROBIT``.
 
-**Use with caution. If you click on the drive while it shows as ``MAINTENANCE``, 
+### ~ hint
+
+Use with caution. If you click on the drive while it shows as ``MAINTENANCE``, 
 you can see which version of firmware you have running on your micro:bit. 
 Firmware on your micro:bit should be up-to-date already. 
 You can find the version of firmware in the 'version.txt' file on the micro:bit. Further information on the firmware can be found here:
 
 https://developer.mbed.org/platforms/Microbit/#firmware
 
+### ~
+
 ### Compass
 
 The compass can detect magnetic fields such as the Earth’s magnetic field. 
@@ -51,14 +64,22 @@ Output is in milli-g. The device will also detect a small number of standard act
 
 ### Pins
 
-The pins can be a form of input or output. 
+The [pins](/device/pins) can be a form of electrical input or output. 
-There are labels for the input/output pins P0, P1, P2, which you can attach external sensors to such as thermometers or moisture detectors. 
+There are labels for the input/output pins ``P0``, ``P1``, ``P2``, which you can attach external sensors to such as thermometers or moisture detectors.
-You can read more about large and small pins [here](/device/pins).
 
 ### Light level
 
 The screen can also be used a light level sensor (it's a really cool trick).
 
+### Runtime
+
+The micro:bit embodies many fundamental concepts in computer science. To learn more, read [the micro:bit - a reactive system](/device/reactive).
+
+
+Sometimes, your micro:bit may display an error code. For more information, see:
+
+* [the error codes](/device/error-codes)
+
 ### How do I connect the micro:bit to my computer?
 
 Your micro:bit can be connected to your computer via a micro USB cable. 
@@ -90,4 +111,4 @@ control the micro:bit or the micro:bit can control another BLE device.
 ### Technical Information
 
 The micro:bit has been designed to be a bare-board micro controller for use by children aged 11-12. 
-More information is available at the [BBC web site](http://www.microbit.co.uk/device).
+More information is available at the [Microbit Foundation web site](https://microbit.org/device).

docs/device/contents.md

@@ -1,19 +0,0 @@
-# micro:bit - the device
-
-The micro:bit is a very capable device with many components:
-
-* [the USB connector](/device/usb)
-* [the LED screen](/device/screen)
-* [the buttons]
-* [the accelerometer]
-* [the compass]
-* [the pins](/device/pins)
-* [the battery plug]
-
-The micro:bit embodies many fundamental concepts in computer science. To learn more, read:
-
-* [the micro:bit - a reactive system](/device/reactive)
-
-Sometimes, your micro:bit may display an error code. For more information, see:
-
-* [the error codes](/device/error-codes)

pxtarget.json

@@ -269,6 +269,10 @@
             {
                 "name": "Hardware",
                 "path": "/device"
+            },
+            {
+                "name": "Shop",
+                "path": "https://microbit.org/resellers"
             }
         ],
         "hasReferenceDocs": true,