From 7a0a2fbd0a426eec87fa3557218fcb2a20613305 Mon Sep 17 00:00:00 2001
From: Ron Hale-Evans <rwhe@ludism.org>
Date: Wed, 29 Jun 2016 12:41:35 -0700
Subject: [PATCH] Rewrote in simple language. Added hint about averaging read
 values.

---
 docs/reference/pins/analog-read-pin.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/reference/pins/analog-read-pin.md b/docs/reference/pins/analog-read-pin.md
index fceccfe0..45e9bd3c 100644
--- a/docs/reference/pins/analog-read-pin.md
+++ b/docs/reference/pins/analog-read-pin.md
@@ -9,7 +9,7 @@ pins.analogReadPin(AnalogPin.P0)
 
 ### Parameters
 
-* a [string](/reference/types/string) that stores the name of the pin
+* a [string](/reference/types/string) with the name of the pin
   you say (`P0` through `P4`, or `P10`)
 
 ### Returns
@@ -26,6 +26,14 @@ basic.forever(() => {
 });
 ```
 
+#### ~hint
+
+If you are using **analog read pin** with another micro:bit
+running **analog write pin**, it is a good idea to check
+**analog read pin** many times and then take an average.
+
+#### ~
+
 ### See also
 
 [micro:bit pins](/device/pins),