From 8751d2aaa1dd4bccaa194cf71641ab2fb9303293 Mon Sep 17 00:00:00 2001
From: Ron Hale-Evans <rwhe@ludism.org>
Date: Fri, 8 Jul 2016 15:29:14 -0700
Subject: [PATCH] Rewrote one Serial topic; shifted some material

---
 docs/reference/serial/write-line.md   |  3 ++-
 docs/reference/serial/write-number.md | 19 ++++++++++++++++---
 docs/reference/serial/write-value.md  | 25 ++++++++++++-------------
 3 files changed, 30 insertions(+), 17 deletions(-)

diff --git a/docs/reference/serial/write-line.md b/docs/reference/serial/write-line.md
index d6c10912..804e1be7 100644
--- a/docs/reference/serial/write-line.md
+++ b/docs/reference/serial/write-line.md
@@ -11,7 +11,7 @@ serial.writeLine("");
 
 * `line` is the [string](/reference/types/string) to write to the serial port
 
-### Example
+### Example: simple serial
 
 This program writes the word `BOFFO` to the serial port repeatedly.
 
@@ -47,4 +47,5 @@ basic.forever(() => {
 ### See also
 
 [serial](/device/serial),
+[serial write number](/reference/serial/write-number),
 [serial write value](/reference/serial/write-value)
diff --git a/docs/reference/serial/write-number.md b/docs/reference/serial/write-number.md
index 61ac3eee..1affa2f9 100644
--- a/docs/reference/serial/write-number.md
+++ b/docs/reference/serial/write-number.md
@@ -10,7 +10,7 @@ serial.writeNumber(0);
 
 * `number` is the [number](/reference/types/number) to write to the serial port
 
-### Example
+### Example: one through ten
 
 This program repeatedly writes a 10-digit number to the serial port.
 
@@ -21,8 +21,21 @@ basic.forever(() => {
 });
 ```
 
+### Example: plot bar graph does serial
+
+If you use the ``led.plotBarGraph`` function, it writes the number
+being plotted to the serial port too.
+
+```blocks
+basic.forever(() => {
+    led.plotBarGraph(input.lightLevel(), 255)
+    basic.pause(10000);
+})
+```
+
 ### See also
 
 [serial](/device/serial),
-[serial write value](/reference/serial/write-value),
-[serial write line](/reference/serial/write-line)
+[serial write line](/reference/serial/write-line),
+[serial write value](/reference/serial/write-value)
+
diff --git a/docs/reference/serial/write-value.md b/docs/reference/serial/write-value.md
index a764ae54..e9a3aaa3 100644
--- a/docs/reference/serial/write-value.md
+++ b/docs/reference/serial/write-value.md
@@ -1,6 +1,6 @@
 # Write Value
 
-Writes name/value pair and a new line character (`\r\n`) to [serial](/device/serial).
+Write a name/value pair and a newline character (`\r\n`) to the [serial](/device/serial) port.
 
 ```sig
 serial.writeValue("x", 0);
@@ -8,7 +8,8 @@ serial.writeValue("x", 0);
 
 ### Example: streaming data
 
-The sample below sends the temperature and light level every 10 seconds.
+Every 10 seconds, the example below sends the temperature and light level
+to the serial port.
 
 ```blocks
 basic.forever(() => {
@@ -18,19 +19,17 @@ basic.forever(() => {
 })
 ```
 
-### Plot bar graph does serial!
+#### ~hint
 
-If you use the `led.plotBarGraph` function, it automatically writes the value to the serial as well.
-
-```blocks
-basic.forever(() => {
-    led.plotBarGraph(input.lightLevel(), 255)
-    basic.pause(10000);
-})
-```
+The [send value](/reference/radio/send-value) function broadcasts
+string/number pairs.  You can use a second micro:bit to receive them,
+and then send them directly to the serial port with ``write value``.
 
+#### ~
 
 ### See also
 
-[serial](/device/serial), [write line](/reference/serial/write-line)
-
+[serial](/device/serial),
+[serial write line](/reference/serial/write-line),
+[serial write number](/reference/serial/write-number),
+[send value](/reference/radio/send-value)