doc updates

docs/docs.md

@@ -1,8 +1,35 @@
 # Documentation
 
-Welcome to the documentation.
+```sim
+basic.forever(() => {
+  basic.showString("DOCS ");
+})
+input.onButtonPressed(Button.A, () => {
+    led.stopAnimation();
+    basic.showLeds(`
+. . . . .
+. # . # .
+. . . . .
+# . . . #
+. # # # .`);
+});
+input.onButtonPressed(Button.B, () => {
+    led.stopAnimation();
+    basic.showLeds(`
+. # . # .
+# . # . #
+# . . . #
+. # . # .
+. . # . .`);
+});
+``` 
 
+* **[getting started](/getting-started)**   
 * Browse the [API reference](/reference)
 * Learn more about the [device](/device)
 * Get started with [lessons](/lessons)
-* Learn about [libraries](/libraries) (possibly using C++)
+* Follow up with the [release notes](/release-notes)
+
+### Developers
+
+* Learn about [packages](/packages) (possibly using C++ or ARM thumb)

docs/getting-started.md

@@ -2,7 +2,7 @@
 
 Are you ready to build cool BBC micro:bit programs? For each challenge, reorder the blocks to recreate the program.
 
-* If you haven't done so, open [https://m.pxt.io](/) and create a new **Blocks Editor** project
+## Open [https://m.pxt.io](/) and create a new **Blocks Editor** project
 
 ## Basic
 
@@ -28,10 +28,9 @@ To transfer your code to the BBC micro:bit,
 
 ### Show animation Forever
 
-Show one image after the other to create an animation.,
+Show one image after the other to create an animation by snapping them together.
 
-Reorder the blocks to make the micro:bit show a happy, then unhappy face.
+```blocks
-```shuffle
     basic.showLeds(`
         . . . . .
         . # . # .
@@ -48,6 +47,7 @@ Reorder the blocks to make the micro:bit show a happy, then unhappy face.
         `)
 ```
 
+
 ### Repeat forever
 
 Use the ``forever`` block to repeat your code and have a continuous animation.

docs/open-source.md

@@ -0,0 +1,9 @@
+# Open Source
+
+The editor is open source on GitHub under the MIT license. Contributions are welcome, please check our GitHub repos.
+
+### Repos
+
+* [microbit/pxt](https://github.com/Microsoft/pxt), programming experience toolkit (PXT)
+* [microsoft/pxt-microbit](https://github.com/Microsoft/pxt-microbit), PXT target for BBC micro:bit
+* [microsoft/pxt-microbit-core](https://github.com/Microsoft/pxt-microbit-core), Yotta module used to build the BBC micro:bit runtime

docs/release-notes.md

@@ -0,0 +1,11 @@
+# Release notes
+
+```sim
+basic.forever(() => { basic.showString("RELEASE NOTES"); });
+```
+
+### May 2017
+
+We're happy to announce [m.pxt.io](https://m.pxt.io), an Blocks/JavaScript editor for the [BBC micro:bit](https://www.microbit.co.uk).
+
+The editor is [open source](/open-source) on GitHub. Send us your PR!