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

docs/reference/basic.md

@@ -4,6 +4,7 @@ Provides access to basic @boardname@ functionality.
 
 ```cards
 basic.showNumber(0);
+basic.showIcon(IconNames.Heart);
 basic.showLeds(`
 . . . . .
 . . . . .
@@ -35,6 +36,8 @@ basic.showAnimation(`
 
 ### See Also
 
-[showNumber](/reference/basic/show-number), [showLeds](/reference/basic/show-leds), [showString](/reference/basic/show-string), 
+[showNumber](/reference/basic/show-number), 
+[showIcon](/reference/basic/show-icon),
+[showLeds](/reference/basic/show-leds), [showString](/reference/basic/show-string), 
 [clearScreen](/reference/basic/clear-screen), [forever](/reference/basic/forever), [pause](/reference/basic/pause), 
 [showAnimation](/reference/basic/show-animation)

docs/reference/basic/show-icon.md

@@ -0,0 +1,22 @@
+# Show Icon
+
+Shows the selected icon on the LED screen
+
+```sig
+basic.showIcon(IconNames.Heart)
+```
+
+### Example
+
+This program shows a happy face and then a sad face with the ``show icon`` function, with a one second pause in between.
+
+```blocks
+basic.showIcon(IconNames.Happy)
+basic.pause(1000)
+basic.showIcon(IconNames.Sad)
+```
+
+### See also
+
+[show leds](/reference/led/show-leds)
+