From a6b2187ec558341be3ac4b4592621ed6f7f2fe5a Mon Sep 17 00:00:00 2001
From: Ron Hale-Evans <rwhe@ludism.org>
Date: Thu, 28 Jul 2016 10:56:37 -0700
Subject: [PATCH] Edited advanced page

---
 docs/reference/radio/write-value-to-serial.md | 34 +++++++++++++------
 1 file changed, 23 insertions(+), 11 deletions(-)

diff --git a/docs/reference/radio/write-value-to-serial.md b/docs/reference/radio/write-value-to-serial.md
index 390e3e46..b65feada 100644
--- a/docs/reference/radio/write-value-to-serial.md
+++ b/docs/reference/radio/write-value-to-serial.md
@@ -1,18 +1,26 @@
 # Write Value To Serial
 
-Writes the full data received data  via ``radio`` to serial in JSON format.   
-
-**Note** - This method only works for [send number](/reference/radio/send-number) and [send value](/reference/radio/send-value). It does not work for [send string](/reference/radio/send-string) (although a string can be sent with [send value](/reference/radio/send-value)).   
+Writes the data received by ``radio`` to serial in JSON format.
 
 ```sig
 radio.writeValueToSerial();
 ```
 
-## Data received format
-The format for received data printed to serial is as follows    
-- [send number](/reference/radio/send-number) - ```{v:ValueSent,t:MicrobitTimeAlive,s:Unused}```
-- [send value](/reference/radio/send-number) - ```{v:Value,t:MicrobitTimeAlive,s:Unused,n:"Name"}```
-- [send string](/reference/radio/send-string) - ```{}``` (currently unavailable)
+### ~hint
+
+This method only works for [send number](/reference/radio/send-number)
+and [send value](/reference/radio/send-value). It does not work for
+[send string](/reference/radio/send-string), although you can send a
+string as part of [send value](/reference/radio/send-value).
+
+### ~
+
+### Data received format
+
+The format for received data printed to serial is as follows:
+
+- [send number](/reference/radio/send-number): ```{v:ValueSent,t:MicrobitTimeAlive,s:Unused}```
+- [send value](/reference/radio/send-value): ```{v:ValueSent,t:MicrobitTimeAlive,s:Unused,n:"Name"}```
 
 ### Simulator
 
@@ -20,7 +28,9 @@ This function only works on the micro:bit, not in browsers.
 
 ### Examples
 
-When ```radio``` data is received (after pressing A button on 2nd micro:bit), output temperature data to serial.
+When ```radio``` data is received (after pressing the ``A`` button on
+the second micro:bit), this program sends temperature data to
+serial.
 
 ```blocks
 input.onButtonPressed(Button.A, () => {
@@ -30,9 +40,11 @@ radio.onDataReceived(() => {
     radio.writeValueToSerial();
 });
 ```
-Example output to serial when A button pressed:   
+Sample output to serial when ``A`` button pressed:
 ```{v:27,t:323,s:0}```
 
 ### See also
 
-[send number](/reference/radio/send-number), [send value](/reference/radio/send-number), [on data received](/reference/radio/on-data-received)
+[send number](/reference/radio/send-number),
+[send value](/reference/radio/send-value),
+[on data received](/reference/radio/on-data-received)