From 8617f0f3b496d059bfccd8dc96bc0e5ebd628b54 Mon Sep 17 00:00:00 2001
From: Ron Hale-Evans <rwhe@ludism.org>
Date: Thu, 23 Jun 2016 15:25:56 -0700
Subject: [PATCH] Expanded stub. Rewrote in simple language.

---
 docs/reference/control/reset.md | 31 ++++++++++++++++++++++++++++++-
 1 file changed, 30 insertions(+), 1 deletion(-)

diff --git a/docs/reference/control/reset.md b/docs/reference/control/reset.md
index 16c985ee..59ba8cbe 100644
--- a/docs/reference/control/reset.md
+++ b/docs/reference/control/reset.md
@@ -1,8 +1,37 @@
 # Reset
 
-Reset the BBC micro:bit (as if you pushed the reset button on the back of the device), which causes the program to start again.
+Reset the BBC micro:bit and start the program again.
+
+This function is like pressing the reset button on the back of the micro:bit.
 
 ```sig
 control.reset()
 ```
 
+### Example
+
+This program will count as high as you like when you press button `A`.
+When you get tired of counting, press button `B` to reset the
+micro:bit and start the program over.
+
+```blocks
+let item = 0;
+basic.showNumber(item);
+input.onButtonPressed(Button.A, () => {
+    item = item + 1;
+    basic.showNumber(item);
+});
+input.onButtonPressed(Button.B, () => {
+    control.reset();
+});
+```
+
+#### ~hint
+
+This program works better on a real micro:bit than in the simulator.
+
+#### ~
+
+### See Also
+
+[clear screen](/reference/basic/clear-screen), [game over](/reference/game/game-over)