diff --git a/hardware/HummingboardGPIO/README.md b/hardware/HummingboardGPIO/README.md
index b4b0ccab..cb367c40 100644
--- a/hardware/HummingboardGPIO/README.md
+++ b/hardware/HummingboardGPIO/README.md
@@ -8,14 +8,14 @@ Install
 
 **This install is for Debian based OS on Hummingboard.**
 
-Run the following command in the root directory of your Node-RED install:
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
     npm install node-red-node-hpgpio
 
 **Note :** This **should** be run as root in order to move and set SUID permissions on a script to talk to the gpio pins. Alternatively you can run as a normal user and then move the file and change permissions manually.
 
     sudo cp node_modules/node-red-node-hpgpio/gpiohb /usr/local/bin/
-    sudo chmod 4755 /usr/lcoal/bin/gpiohb
+    sudo chmod 4755 /usr/local/bin/gpiohb
 
 
 Usage
@@ -27,19 +27,19 @@ This requires a small script (gpiohb) to run as root in order to work. It should
 
 **Note:** We are using the actual physical pin numbers as they are easier to locate.
 
-###Output node
+### Output node
 
-Expects a <b>msg.payload</b> with either a 0 or 1 (or true or false).
+Expects a `msg.payload` with either a 0 or 1 (or true or false).
 
 Will set the selected physical pin high or low depending on the value passed in.
 
 The initial value of the pin at deploy time can also be set to 0 or 1.
 
 
-###Input node
+### Input node
 
-Generates a **msg.payload** with either a 0 or 1 depending on the state of the input pin.
+Generates a `msg.payload` with either a 0 or 1 depending on the state of the input pin.
 
-The **msg.topic** is set to **pin/{the pin number}**
+The `msg.topic` is set to *pin/{the pin number}*
 
 **Note:** The input node waits for a change on the level of the pin before reading the value - and then resets to wait for the next interrupt - so it is possible to miss very fast changes as we may still be reading the value when the second edge occurs.
diff --git a/hardware/HummingboardGPIO/hb-gpio.html b/hardware/HummingboardGPIO/hb-gpio.html
index 6c4aa762..5ebcf972 100644
--- a/hardware/HummingboardGPIO/hb-gpio.html
+++ b/hardware/HummingboardGPIO/hb-gpio.html
@@ -52,9 +52,9 @@
 </script>
 
 <script type="text/x-red" data-help-name="hb-gpio in">
-    <p>Hummingboard GPIO input pin node. Generates a <b>msg.payload</b> with either a 0 or 1 depending on the state of the input pin.</p>
+    <p>Hummingboard GPIO input pin node. Generates a <code>msg.payload</code> with either a 0 or 1 depending on the state of the input pin.</p>
     <p>You may also enable the input pullup resitor or the pulldown resistor.</p>
-    <p>The <b>msg.topic</b> is set to <i>pi/{the pin number}</i></p>
+    <p>The <code>msg.topic</code> is set to <i>pi/{the pin number}</i></p>
     <p><b>Note:</b> we are using the actual physical pin numbers on connector P1 as they are easier to locate.</p>
     <p><b>Note:</b> requires the gpiohb command to be executeable as root in order to work.</p>
 </script>
@@ -120,7 +120,7 @@
 </script>
 
 <script type="text/x-red" data-help-name="hb-gpio out">
-    <p>Hummingboard GPIO output pin node. Expects a <b>msg.payload</b> with either a 0 or 1 (or true or false).</p>
+    <p>Hummingboard GPIO output pin node. Expects a <code>msg.payload</code> with either a 0 or 1 (or true or false).</p>
     <p>Will set the selected physical pin high or low depending on the value passed in.</p>
     <p>The initial value of the pin at deploy time can also be set to 0 or 1.</p>
     <p><b>Note:</b> we are using the actual physical pin numbers as they are easier to locate.</p>
diff --git a/hardware/HummingboardGPIO/package.json b/hardware/HummingboardGPIO/package.json
index 93471010..a19df1aa 100644
--- a/hardware/HummingboardGPIO/package.json
+++ b/hardware/HummingboardGPIO/package.json
@@ -1,6 +1,6 @@
 {
     "name"         : "node-red-node-hbgpio",
-    "version"      : "0.0.3",
+    "version"      : "0.0.4",
     "description"  : "A Node-RED node for the GPIO of the Hummingboard",
     "dependencies": {
     },
diff --git a/hardware/PiFace/37-rpi-piface.html b/hardware/PiFace/37-rpi-piface.html
index f2b77a35..bc597ffd 100644
--- a/hardware/PiFace/37-rpi-piface.html
+++ b/hardware/PiFace/37-rpi-piface.html
@@ -58,9 +58,10 @@
 </script>
 
 <script type="text/x-red" data-help-name="rpi-piface in">
-    <p>Raspberry Pi PiFace input node. Generates a <b>msg.payload</b> with either a 0 or 1 depending on the state of the input pin.</p>
+    <p>Raspberry Pi PiFace input node. Generates a <code>msg.payload</code> with either a 0 or 1 depending
+    on the state of the input pin.</p>
     <p>You may also enable the input pullup resistor if required.</p>
-    <p>The <b>msg.topic</b> is set to <i>piface/{the pin number}</i></p>
+    <p>The <code>msg.topic</code> is set to <i>piface/{the pin number}</i></p>
     <p>Requires the WiringPi gpio command in order to work.</p>
     <p><b>Note:</b> This node currently polls the pin every 250mS. This is not ideal as it loads the cpu.</p>
     <p><b>Note:</b> Some versions of the PiFace relabelled the switch inputs to be 0 - 7 instead of 1 - 8. 
@@ -127,7 +128,7 @@
 
 <script type="text/x-red" data-help-name="rpi-piface out">
     <p>Raspberry Pi PiFace output node. The PiFace board must be fitted.</p>
-    <p>Will set the selected relay, LED, or pin on or off depending on the value passed in. Expects a <b>msg.payload</b> with either a 1 or 0 (or true or false).</p>
+    <p>Will set the selected relay, LED, or pin on or off depending on the value passed in. Expects a <code>msg.payload</code> with either a 1 or 0 (or true or false).</p>
     <p>Requires the WiringPi gpio command in order to work.</p>
 </script>
 
diff --git a/hardware/PiFace/README.md b/hardware/PiFace/README.md
index 6e475758..5aa363f3 100644
--- a/hardware/PiFace/README.md
+++ b/hardware/PiFace/README.md
@@ -12,7 +12,7 @@ We cannot automatically detect this so the user will have to apply some common s
 Install
 -------
 
-Run the following command in the root directory of your Node-RED install
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
     npm install node-red-node-piface
 
@@ -46,19 +46,19 @@ add-on board.
 ### Output
 
 The PiFace output node will set the selected relay, LED, or pin on or off
-depending on the value passed in. Expects a <b>msg.payload</b> with either a
+depending on the value passed in. Expects a `msg.payload` with either a
 1 or 0 (or true or false).
 
 Requires the WiringPi gpio command in order to work (see pre-reqs).
 
 ### Input
 
-The PiFace input node generates a <b>msg.payload</b> with either a 0 or 1
+The PiFace input node generates a `msg.payload` with either a 0 or 1
 depending on the state of the input pin.
 
 You may also enable the input pullup resistor if required.
 
-The <b>msg.topic</b> is set to <i>piface/{the pin number}</i>
+The `msg.topic` is set to <i>piface/{the pin number}</i>
 
 Requires the WiringPi gpio command in order to work (see pre-reqs).
 
diff --git a/hardware/PiFace/package.json b/hardware/PiFace/package.json
index 1894f119..1c58b9d3 100644
--- a/hardware/PiFace/package.json
+++ b/hardware/PiFace/package.json
@@ -1,6 +1,6 @@
 {
     "name"          : "node-red-node-piface",
-    "version"       : "0.0.6",
+    "version"       : "0.0.7",
     "description"   : "Node-RED nodes to read from and write to a PiFace Digital Raspberry Pi add-on board",
     "dependencies"  : {
     },
diff --git a/hardware/PiLcd/README.md b/hardware/PiLcd/README.md
index 385d75e7..0f8d5468 100644
--- a/hardware/PiLcd/README.md
+++ b/hardware/PiLcd/README.md
@@ -7,8 +7,7 @@ to write to a GPIO connected HD44780 style LCD panels.
 Install
 -------
 
-Run the following command in the root directory of your Node-RED install.
-This is normally `~/.node-red`
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
     npm install node-red-node-pilcd
 
@@ -23,7 +22,7 @@ pin numbers that are connected to the RS, E, D4, D5, D6 and D7 pins of the LCD.
 
         26,24,22,18,16,12
 
-Send the node a **msg.payload** with a string in it.
+Send the node a `msg.payload` with a string in it.
 
 Strings for the 2nd line of the display must start **2:** - the third start **3:** - and the fourth **4:** - For example
 
diff --git a/hardware/PiLcd/package.json b/hardware/PiLcd/package.json
index 79b16929..5c373620 100644
--- a/hardware/PiLcd/package.json
+++ b/hardware/PiLcd/package.json
@@ -1,6 +1,6 @@
 {
     "name"          : "node-red-node-pilcd",
-    "version"       : "0.0.3",
+    "version"       : "0.0.4",
     "description"   : "A Node-RED node for Raspberry Pi to write to HD44780 style LCD panels.",
     "dependencies"  : {
     },
diff --git a/hardware/PiLcd/pilcd.html b/hardware/PiLcd/pilcd.html
index 87dab382..ffabd048 100644
--- a/hardware/PiLcd/pilcd.html
+++ b/hardware/PiLcd/pilcd.html
@@ -30,7 +30,7 @@
 
 <script type="text/x-red" data-help-name="rpi-lcd">
     <p>Raspberry Pi output to a HD44780 style LCD. Usually 1, 2, or 4 lines of characters.</p>
-    <p>Expects a <b>msg.payload</b> with a string in it.</p>
+    <p>Expects a <code>msg.payload</code> with a string in it.</p>
     <p>Strings for the second line of the display must start <b>2:</b> - the third start <b>3:</b> - and the fourth <b>4:</b></p>
     <p>To clear the display send the string <b>clr:</b></p>
     <p>It is up to you to manage string lengths to suit the display.</p>
diff --git a/hardware/PiLiter/README.md b/hardware/PiLiter/README.md
index 8bff3f9d..6cd05a79 100644
--- a/hardware/PiLiter/README.md
+++ b/hardware/PiLiter/README.md
@@ -6,7 +6,7 @@ A <a href="http://nodered.org" target="_new">Node-RED</a> node to control a Pimo
 Install
 -------
 
-Run the following command in the root directory of your Node-RED install
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
     npm install node-red-node-piliter
 
diff --git a/hardware/PiLiter/package.json b/hardware/PiLiter/package.json
index bfa75d1f..633dde7d 100644
--- a/hardware/PiLiter/package.json
+++ b/hardware/PiLiter/package.json
@@ -1,6 +1,6 @@
 {
     "name"          : "node-red-node-piliter",
-    "version"       : "0.0.8",
+    "version"       : "0.0.9",
     "description"   : "A Node-RED node to drive a Raspberry Pi Pi-LITEr 8 LED board.",
     "dependencies"  : {
     },
diff --git a/hardware/PiSrf/README.md b/hardware/PiSrf/README.md
index 961faba8..d9735f52 100644
--- a/hardware/PiSrf/README.md
+++ b/hardware/PiSrf/README.md
@@ -9,8 +9,7 @@ to read range from an SRF05 Ultrasonic range sensor.
 Install
 -------
 
-Run the following command in the root directory of your Node-RED install.
-This is usually `~/.node-red`
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
     npm install node-red-node-pisrf
 
@@ -19,12 +18,12 @@ Usage
 
 Raspberry Pi input from an SRF04 or SRF05 ultrasonic range finder.
 
-The configuartion requires two GPIO pin numbers, the trigger pin and the echo pin.
+The configuration requires two GPIO pin numbers, the trigger pin and the echo pin.
 These can be any spare valid Pi GPIO pins. e.g.
 
         7,11
 
-Outputs a <b>msg.payload</b> with a number representing the range in cm.
+Outputs a `msg.payload` with a number representing the range in cm.
 
 Produces one measure every 0.5s - but only if the distance is different from the previous reading.
 
diff --git a/hardware/PiSrf/package.json b/hardware/PiSrf/package.json
index 1c28216f..eedc9012 100644
--- a/hardware/PiSrf/package.json
+++ b/hardware/PiSrf/package.json
@@ -1,6 +1,6 @@
 {
     "name"          : "node-red-node-pisrf",
-    "version"       : "0.0.1",
+    "version"       : "0.0.2",
     "description"   : "A Node-RED node for a Raspberry Pi to use a SRF04 or SRF05 range finder",
     "dependencies"  : {
     },
diff --git a/hardware/PiSrf/pisrf.html b/hardware/PiSrf/pisrf.html
index 00ed8036..8713979a 100644
--- a/hardware/PiSrf/pisrf.html
+++ b/hardware/PiSrf/pisrf.html
@@ -30,7 +30,7 @@
 
 <script type="text/x-red" data-help-name="rpi-srf">
     <p>Raspberry Pi input from an SRF04 or SRF05 ultrasonic range finder.</p>
-    <p>Outputs a <b>msg.payload</b> with a number representing the range in cm.</p>
+    <p>Outputs a <code>msg.payload</code> with a number representing the range in cm.</p>
     <p>Produces one measure every 0.5s - but only if the distance is different from the previous reading.</p>
     <p><b>Note:</b> we are using the actual physical pin numbers on connector P1 as they are easier to locate.</p>
 </script>
diff --git a/hardware/Pibrella/38-rpi-pibrella.html b/hardware/Pibrella/38-rpi-pibrella.html
index 1aeea99c..4b388f2a 100644
--- a/hardware/Pibrella/38-rpi-pibrella.html
+++ b/hardware/Pibrella/38-rpi-pibrella.html
@@ -105,7 +105,7 @@
         <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
     </div>
-    <div class="form-tips" id="node-buzz-tip">Buzzer expects <b>msg.payload</b> to be a number in Hz.</div>
+    <div class="form-tips" id="node-buzz-tip">Buzzer expects <code>msg.payload</code> to be a number in Hz.</div>
 </script>
 
 <script type="text/x-red" data-help-name="rpi-pibrella out">
diff --git a/hardware/Pibrella/README.md b/hardware/Pibrella/README.md
index 192370ca..112b0bde 100644
--- a/hardware/Pibrella/README.md
+++ b/hardware/Pibrella/README.md
@@ -5,7 +5,7 @@ A <a href="http://nodered.org" target="_new">Node-RED</a> node to control a <a h
 Install
 -------
 
-Run the following command in the root directory of your Node-RED install
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
     npm install node-red-node-pibrella
 
@@ -22,16 +22,16 @@ Usage
 
 A pair of input and output Node-RED nodes for the Raspberry Pi Pibrella from Pimoroni.
 
-###Output
+### Output
 
-The output node will set the selected output high (on) or low (off) depending on the value passed in. Expects a <b>msg.payload</b> with either a 0 or 1 (or true or false).
+The output node will set the selected output high (on) or low (off) depending on the value passed in. Expects a `msg.payload` with either a 0 or 1 (or true or false).
 
 You may also select PWM mode to dim the on board LEDs if you wish. Expects a value from 0 to 100.
 
 The Buzzer expects a number representing the frequency in Hz. 0 is off and 1 is a tone - so you can use 0/1 type inputs as well.
 
-###Input
+### Input
 
-The input node generates a <b>msg.payload</b> with either a 0 or 1 depending on the state of the input pin.
+The input node generates a `msg.payload` with either a 0 or 1 depending on the state of the input pin.
 
-The <b>msg.topic</b> is set to <i>pibrella/{the pin id}</i> - which will be A, B, C, D or R.
+The `msg.topic` is set to <i>pibrella/{the pin id}</i> - which will be A, B, C, D or R.
diff --git a/hardware/Pibrella/package.json b/hardware/Pibrella/package.json
index 3ffee2dc..2c4cbca3 100644
--- a/hardware/Pibrella/package.json
+++ b/hardware/Pibrella/package.json
@@ -1,6 +1,6 @@
 {
     "name"          : "node-red-node-pibrella",
-    "version"       : "0.0.10",
+    "version"       : "0.0.11",
     "description"   : "A Node-RED node to read from and write to a Pibrella Raspberry Pi add-on board",
     "dependencies"  : {
     },
diff --git a/hardware/blink1/README.md b/hardware/blink1/README.md
index b7fa25e9..4cb930ac 100644
--- a/hardware/blink1/README.md
+++ b/hardware/blink1/README.md
@@ -22,18 +22,17 @@ and also setup these udev rules in `/etc/udev/rules.d/51-blink1.rules`
 Install
 -------
 
-Run the following command in the user directory of your Node-RED install.
-This is usually `~/.node-red`
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
     npm i node-red-node-blink1
 
 Usage
 -----
 
-Sends the <b>msg.payload</b> to a Thingm Blink(1) LED device. The payload can be any of the following:
+Sends the `msg.payload` to a Thingm Blink(1) LED device. The payload can be any of the following:
 
  - a three part csv string of r,g,b - e.g. red is  255,0,0
  - a hex colour #rrggbb - e.g. green is  #00FF00
  - a <a href="http://www.cheerlights.com/control-cheerlights">@cheerlights</a> colour name - e.g. blue
 
- The colours it accepts are - red, amber, green, blue, cyan, magenta, yellow, orange, pink, purple, white, warmwhite (or oldlace), black, (or off)
+ The colours it accepts are - red, amber, green, blue, cyan, magenta, yellow, orange, pink, purple, white, warmwhite (or oldlace), black, (and off)
diff --git a/hardware/blinkstick/README.md b/hardware/blinkstick/README.md
index 26ec713d..4eaeecc4 100644
--- a/hardware/blinkstick/README.md
+++ b/hardware/blinkstick/README.md
@@ -23,15 +23,15 @@ and either reload the udev rules or reboot.
 Install
 -------
 
-Run the following command in the user directory of your Node-RED install.
-Usually this is `~/.node-red`
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
-    npm install node-red-node-blinkstick
+    npm i node-red-node-blinkstick
 
 Usage
 -----
 
-<i><a href="http://www.blinkstick.com" target="_new">BlinkStick</a></i> output node. Expects a <b>msg.payload</b> with one of:
+<i><a href="http://www.blinkstick.com" target="_new">BlinkStick</a></i> output node.
+Expects a `msg.payload` with one of:
 
 * A hex string <b>"#rrggbb"</b> triple
 * <b>"red,green,blue"</b> three 0-255 values as a string
@@ -43,5 +43,5 @@ An object payload can override any of the settings on the node. Omitted paramete
 
     { 'color': 'blue' }
     { 'task': 'blink', 'color': 'red' }
-    { 'task': 'pulse', 'color': 'gree', 'duration': 500 }
+    { 'task': 'pulse', 'color': 'green', 'duration': 500 }
     { 'task': 'morph', 'color': 'orange', 'duration': 500, 'steps': 20 }
diff --git a/hardware/blinkstick/package.json b/hardware/blinkstick/package.json
index 3c0c17d2..a58b764a 100644
--- a/hardware/blinkstick/package.json
+++ b/hardware/blinkstick/package.json
@@ -1,6 +1,6 @@
 {
     "name"          : "node-red-node-blinkstick",
-    "version"       : "0.1.11",
+    "version"       : "0.1.12",
     "description"   : "A Node-RED node to control a Blinkstick",
     "dependencies"  : {
         "blinkstick"   : "1.1.3"
diff --git a/hardware/digiRGB/78-digiRGB.html b/hardware/digiRGB/78-digiRGB.html
index 34800f09..aba7e360 100644
--- a/hardware/digiRGB/78-digiRGB.html
+++ b/hardware/digiRGB/78-digiRGB.html
@@ -19,12 +19,12 @@
         <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="DigiSpark">
     </div>
-    <div class="form-tips">Expects a msg.payload with three part csv string of r,g,b.</div>
+    <div class="form-tips">Expects a <code>msg.payload</code> with three part csv string of r,g,b.</div>
 </script>
 
 <script type="text/x-red" data-help-name="digiRGB">
     <p>Simple output node to drive digispark RGB</p>
-    <p>Requires <b>msg.payload</b> to be of the form 'r,g,b' decimals 0-255, or a hex string "#rrggbb". For example:</p>
+    <p>Requires <code>msg.payload</code> to be of the form 'r,g,b' decimals 0-255, or a hex string "#rrggbb". For example:</p>
     <ul><li>Red : "255,0,0"</li><li>Green : "#00FF00"</li></ul>
 </script>
 
diff --git a/hardware/digiRGB/README.md b/hardware/digiRGB/README.md
index 665a52d4..3735ea21 100644
--- a/hardware/digiRGB/README.md
+++ b/hardware/digiRGB/README.md
@@ -6,10 +6,9 @@ A <a href="http://nodered.org" target="_new">Node-RED</a> node to control a <a h
 Install
 -------
 
-Run the following command in the home directory of your Node-RED install.
-This is usually `~/.node-red`
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
-    npm install node-red-node-digirgb
+    npm i node-red-node-digirgb
 
 
 Usage
@@ -17,4 +16,4 @@ Usage
 
 Simple output node to drive a Digispark RGB LED.
 
-Requires a <b>msg.payload</b> to be of the form 'r,g,b' - for example 255,0,0  for red.
+Requires a `msg.payload` to be of the form 'r,g,b' - for example 255,0,0  for red.
diff --git a/hardware/digiRGB/package.json b/hardware/digiRGB/package.json
index fea47c25..98f90831 100644
--- a/hardware/digiRGB/package.json
+++ b/hardware/digiRGB/package.json
@@ -1,6 +1,6 @@
 {
     "name"          : "node-red-node-digirgb",
-    "version"       : "0.0.4",
+    "version"       : "0.0.5",
     "description"   : "A Node-RED node to control a Digispark RGB LED",
     "dependencies"  : {
         "node-hid"   : "0.4.*"
diff --git a/hardware/heatmiser/README.md b/hardware/heatmiser/README.md
index 7930c2fe..fdd3b51d 100644
--- a/hardware/heatmiser/README.md
+++ b/hardware/heatmiser/README.md
@@ -6,7 +6,7 @@ A <a href="http://nodered.org" target="_new">Node-RED</a> node to control and po
 Install
 -------
 
-Run the following command in the root directory of your Node-RED install
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
     npm install node-red-contrib-heatmiser
 
@@ -14,22 +14,22 @@ Run the following command in the root directory of your Node-RED install
 Usage
 -----
 
-###Input node###
+### Input node
 
-Expects a **msg.payload** with a JSON object that contains settings for the Heatmiser thermostat
+Expects a `msg.payload` with a JSON object that contains settings for the Heatmiser thermostat
 
-**msg.payload** can currently be either a heating boost option, or a run mode, as below:
+`msg.payload` can currently be either a heating boost option, or a run mode, as below:
 
-####Heating boost####
+#### Heating boost
 
     {heating: {target: TARGET_TEMPERATURE, hold: MINUTES_TO_STAY_ON_FOR}}
 
-####Run mode####
+#### Run mode
 
     {runmode:"frost"}
     {runmode:"heating"}
 
 
-###Output node.###
+### Output node
 
 Will read and send a status update at a configurable time interval. This is set to every 30 minutes by default.
diff --git a/hardware/heatmiser/package.json b/hardware/heatmiser/package.json
index eaa24d3c..1462fb10 100644
--- a/hardware/heatmiser/package.json
+++ b/hardware/heatmiser/package.json
@@ -1,6 +1,6 @@
 {
     "name"          : "node-red-contrib-heatmiser",
-    "version"       : "0.0.2",
+    "version"       : "0.0.3",
     "description"   : "A Node-RED node to control and poll a HeatMiser thermostat.",
     "dependencies"  : {
         "heatmiser"   : "2.0.0"
diff --git a/hardware/intel/README.md b/hardware/intel/README.md
index 46e92033..2d851289 100644
--- a/hardware/intel/README.md
+++ b/hardware/intel/README.md
@@ -7,10 +7,9 @@ Galileo or Edison running mraa.
 Install
 -------
 
-Run the following command in the root directory of your Node-RED install, usually
-this is ~/.node-red .
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
-        npm install node-red-node-intel-gpio
+        npm i node-red-node-intel-gpio
 
 Usage
 -----
@@ -39,7 +38,7 @@ If you do need to install Node-RED, you can do this as follows from the home dir
 ### Analogue Input Node
 
 Monitors the selected pin for changes. It outputs on a change of value.
-As analogue inputs are continously changing you can set the sample rate in ms from 20 to 65535.
+As analogue inputs are continuously changing you can set the sample rate in ms from 20 to 65535.
 
 ### Digital Input Node
 
@@ -48,11 +47,11 @@ Monitors the selected pin for changes. It only outputs on a change of value.
 ### Digital Output Node
 
 Sets the selected digital pin output high or low depending on the value of
-**msg.payload** - expects a number or string 0 or 1.
+`msg.payload` - expects a number or string 0 or 1.
 
 ### Pulse Width Modulation (PWM) Node
 
-The **msg.payload** should contain a floating point number value
+The `msg.payload` should contain a floating point number value
 between 0 (off) and 1 (fully on), or a string representation thereof.
 
 You can set the overall period (mS) in the edit dialogue.
diff --git a/hardware/intel/mraa-gpio-ain.html b/hardware/intel/mraa-gpio-ain.html
index bba11073..5503021a 100644
--- a/hardware/intel/mraa-gpio-ain.html
+++ b/hardware/intel/mraa-gpio-ain.html
@@ -78,7 +78,7 @@
 
 <script type="text/x-red" data-help-name="mraa-gpio-ain">
     <p>An analogue input pin for an Intel Galileo or Edison board that is read every <i>interval</i> milliseconds.</p>
-    <p>The <b>msg.payload</b> will contain the value, and <b>msg.topic</b>
+    <p>The <code>msg.payload</code> will contain the value, and <code>msg.topic</code>
     contains "{the_board_name}/A{the pin number}".</p>
     <p>The value is only sent if it is different from the previously read value.</p>
 </script>
diff --git a/hardware/intel/mraa-gpio-din.html b/hardware/intel/mraa-gpio-din.html
index 26865ae2..d12d0e37 100644
--- a/hardware/intel/mraa-gpio-din.html
+++ b/hardware/intel/mraa-gpio-din.html
@@ -94,6 +94,6 @@
 
 <script type="text/x-red" data-help-name="mraa-gpio-din">
     <p>A digital input pin for an Intel Galileo or Edison board.</p>
-    <p>The <b>msg.payload</b> contains the value (0 or 1), and <b>msg.topic</b>
+    <p>The <code>msg.payload</code> contains the value (0 or 1), and <code>msg.topic</code>
     contains "{the_board_name}/D{the pin number}".</p>
 </script>
diff --git a/hardware/intel/mraa-gpio-dout.html b/hardware/intel/mraa-gpio-dout.html
index 34b5555f..9f1ab189 100644
--- a/hardware/intel/mraa-gpio-dout.html
+++ b/hardware/intel/mraa-gpio-dout.html
@@ -116,5 +116,5 @@
 
 <script type="text/x-red" data-help-name="mraa-gpio-dout">
     <p>A digital output pin for an Intel Galileo or Edison board.</p>
-    <p>The <b>msg.payload</b> should contain the value 0 or 1.</p>
+    <p>The <code>msg.payload</code> should contain the value 0 or 1.</p>
 </script>
diff --git a/hardware/intel/mraa-gpio-pwm.html b/hardware/intel/mraa-gpio-pwm.html
index 740e9cdc..076a4f3c 100644
--- a/hardware/intel/mraa-gpio-pwm.html
+++ b/hardware/intel/mraa-gpio-pwm.html
@@ -96,7 +96,7 @@
 
 <script type="text/x-red" data-help-name="mraa-gpio-pwm">
     <p>A pulse width modulation (PWM) output pin for an Intel Galileo or Edison board.</p>
-    <p>The <b>msg.payload</b> should contain a floating point number value
+    <p>The <code>msg.payload</code> should contain a floating point number value
     between 0 and 1, (or a string representation thereof.)</p>
     <p>For servo control set the period to 20mS and vary the input between 0.05 and 0.10</p>
     <p><b>Note</b> : Only pins 3, 5, 6, 9, 10 & 11 support PWM output.</p>
diff --git a/hardware/intel/package.json b/hardware/intel/package.json
index a5d1074c..82f008f3 100644
--- a/hardware/intel/package.json
+++ b/hardware/intel/package.json
@@ -1,6 +1,6 @@
 {
     "name"          : "node-red-node-intel-gpio",
-    "version"       : "0.0.3",
+    "version"       : "0.0.4",
     "description"   : "A Node-RED node to talk to an Intel Galileo or Edison using mraa",
     "dependencies"  : {
     },
diff --git a/hardware/makey/README.md b/hardware/makey/README.md
index 20bbd99e..8e05457f 100644
--- a/hardware/makey/README.md
+++ b/hardware/makey/README.md
@@ -5,7 +5,7 @@ A <a href="http://nodered.org" target="_new">Node-RED</a> node to read from a Ma
 Install
 -------
 
-Run the following command in the root directory of your Node-RED install
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
     npm install node-red-node-makeymakey
 
diff --git a/hardware/makey/package.json b/hardware/makey/package.json
index 18b5c5be..7920d798 100644
--- a/hardware/makey/package.json
+++ b/hardware/makey/package.json
@@ -1,6 +1,6 @@
 {
     "name"          : "node-red-node-makeymakey",
-    "version"       : "0.0.2",
+    "version"       : "0.0.3",
     "description"   : "A Node-RED node to read from a MakeyMakey input device.",
     "dependencies"  : {
         "hidstream": "2.0.*"
diff --git a/hardware/neopixel/README.md b/hardware/neopixel/README.md
index cedbf794..e14ed032 100644
--- a/hardware/neopixel/README.md
+++ b/hardware/neopixel/README.md
@@ -17,8 +17,7 @@ Pimoroni Getting Started with Unicorn HAT</a> page.
 Install
 -------
 
-Run the following command in the root directory of your Node-RED install.
-Usually this is `~/.node-red`
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
     npm install node-red-node-pi-neopixel
 
@@ -28,7 +27,7 @@ The data pin of the pixels should be connected to physical pin 12 - GPIO 18 of t
 Usage
 -----
 
-To set the background just set **msg.payload** to an `html_colour` name.
+To set the background just set `msg.payload` to an `html_colour` name.
 <a href="http://html-color-codes.info/color-names/" target="_top">Here
 is a list</a> of html_colour names.
 
@@ -36,31 +35,34 @@ It also accepts a string triple `rrr,ggg,bbb` or `#rrggbb`
 
 #### Bar Chart
 
-Defaults style mode using configured foreground and background colours. The foreground colour is used to indicate the number of pixels or length required.
+Defaults style mode using configured foreground and background colours. The
+foreground colour is used to indicate the number of pixels or length required.
 
-It accepts a number in **msg.payload** that can be either the number of pixels,
+It accepts a number in `msg.payload` that can be either the number of pixels,
 or a percentage of the total length.
 
-If you want to change the foreground colour, you can set **msg.payload** to a
-comma separated string of `html_colour,length` or `length,html_colour`. The foreground will then remain that colour until changed again.
+If you want to change the foreground colour, you can set `msg.payload` to a
+comma separated string of `html_colour,length` or `length,html_colour`. The
+foreground will then remain that colour until changed again.
 
 #### Needle
 
 It can also display a needle (single pixel) type gauge.
 The rest of the pixels are set to the background colour on one side, and the foreground colour on the other side of the indicated pixel.
 
-If you want to change the needle colour, you can set **msg.payload** to a
+If you want to change the needle colour, you can set `msg.payload` to a
 comma separated string of `html_colour,length` or `length,html_colour`.
 
 #### Shift left and Shift right
 
 You can also select shift modes where a single colour pixel is added to either
-the start or the end of the strip, shifting all the others along by one. In this mode the `msg.payload` can be specified as either an html colour name, an r,g,b triple or #rrggbb.
+the start or the end of the strip, shifting all the others along by one. In this
+mode the `msg.payload` can be specified as either an html colour name, an r,g,b triple or #rrggbb.
 
 #### Low level "API"
 
-The `nth` pixel of the string can be set by **msg.payload** with a CSV string `n,r,g,b` ,
+The `nth` pixel of the string can be set by `msg.payload` with a CSV string `n,r,g,b` ,
 where r, g and b are 0-255.
 
-A range of pixels from position `x` to `y` can be set by **msg.payload**
+A range of pixels from position `x` to `y` can be set by `msg.payload`
 with a CSV string `x,y,r,g,b`
diff --git a/hardware/neopixel/package.json b/hardware/neopixel/package.json
index 2f56122d..2a0b2dbc 100644
--- a/hardware/neopixel/package.json
+++ b/hardware/neopixel/package.json
@@ -1,6 +1,6 @@
 {
     "name"          : "node-red-node-pi-neopixel",
-    "version"       : "0.0.10",
+    "version"       : "0.0.11",
     "description"   : "A Node-RED node to output to a neopixel (ws2812) string of LEDS from a Raspberry Pi.",
     "dependencies"  : {
     },
diff --git a/hardware/physical-web/README.md b/hardware/physical-web/README.md
index 4ea69d9c..a5e6eefb 100644
--- a/hardware/physical-web/README.md
+++ b/hardware/physical-web/README.md
@@ -1,49 +1,57 @@
-# node-red-node-physical-web
+node-red-node-physical-web
+==========================
 
-install with
+Nodes to allow Node-RED to act as an Eddystone BLE beacon.
 
-npm install node-red-node-physical-web
+Install
+-------
 
-Then on Linux follow these instrucations:
+Run the following command in your Node-RED user directory - typically `~/.node-red`
+
+    npm install node-red-node-physical-web
+
+Then on Linux follow these instructions:
 
 https://github.com/sandeepmistry/bleno#running-on-linux
 
 
-## Physical-Web out
+Usage
+-----
+
+### Physical-Web Out
 
 A node to allow Node-RED to act as an Eddystone beacon broadcasting URLs
 
-### Config
-
-The config window lets you set the inital URL, anouncement power and period for the Eddystone.
+The config window lets you set the initial URL, announcement power and period for the Eddystone.
 
 Any messages received will update the advertised URL from the msg.payload
 
-## Physical-Web in
+## Physical-Web In
 
 A node to scan for local Eddystones and output information about discovered URLs and TLM data.
 
 Two types of messages will be emitted:
 
-- **URL** -
+- **URL**
     - *type* - Eddystone type
     - *txPower* - Received power at 0m in dBm
     - *url* - The URL the beacon is broadcasting
     - *tlm* - TLM data, if the device is interleaving broadcasts
     - *rssi* - RSSI of the beacon
     - *distance* - Estimated distance to the beacon
-- **UID** -
+
+- **UID**
     - *type* - Eddystone type
     - *txPower* - Received power at 0m in dBm
-    - *namespace* - 10-byte ID of namspace
-    - *instance* - 6-byte ID insance
+    - *namespace* - 10-byte ID of namespace
+    - *instance* - 6-byte ID instance
     - *tlm* - TLM data, if the device is interleaving broadcasts
     - *rssi* - RSSI of the beacon
     - *distance* - Estimated distance to the beacon
 
 Where the tlm data will be in the following format
 
-- **tlm** -
+- **tlm**
     - *version* - TLM version
     - *vbatt* - Battery Voltage
     - *temp* - Temperature
diff --git a/hardware/physical-web/package.json b/hardware/physical-web/package.json
index c9572ddf..3305a851 100644
--- a/hardware/physical-web/package.json
+++ b/hardware/physical-web/package.json
@@ -1,6 +1,6 @@
 {
   "name": "node-red-node-physical-web",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "A set of nodes to interact with the Phyical Web",
   "main": "physical-web.js",
   "scripts": {
diff --git a/hardware/unicorn/README.md b/hardware/unicorn/README.md
index c24d1eaa..cdc287e2 100644
--- a/hardware/unicorn/README.md
+++ b/hardware/unicorn/README.md
@@ -16,10 +16,9 @@ Pimoroni Getting Started with Unicorn HAT</a> page.
 Install
 -------
 
-Run the following command in the root directory of your Node-RED install.
-Usually this is `~/.node-red`
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
-    npm install node-red-node-pi-unicorn-hat
+    npm i node-red-node-pi-unicorn-hat
 
 Usage
 -----
@@ -30,23 +29,23 @@ png image, or by specifying a single colour using an r,g,b triple.
 The brightness can also be set in the configuration. Defaults to 20% so as not
 to blind you.
 
-A pixel is set by **msg.payload** with a CSV string `x,y,r,g,b` , where x and y
+A pixel is set by `msg.payload` with a CSV string `x,y,r,g,b` , where x and y
 are 0 to 7, and r, g and b are 0 - 255.
 If `x` or `y` are set to `*` then the complete row or column can be set.
 Setting both `x` and `y` to `*` fills the background.
 Multiple pixels can be specified at once by using `x1,y1,r1,g1,b1,x2,y2,r2,g2,b2,...` etc
 
-The background can also be set to a colour by setting **msg.payload** to an r,g,b triple.
+The background can also be set to a colour by setting `msg.payload` to an r,g,b triple.
 
-Any msg with a **msg.topic** identifies a 'sprite', which can then be moved
+Any msg with a `msg.topic` identifies a 'sprite', which can then be moved
 independently of the background. A 'sprite' can be a single pixel, or a group of pixels.
 
-Setting **msg.payload** to `0` will delete the sprite from the list identified by **msg.topic**.
+Setting `msg.payload` to `0` will delete the sprite from the list identified by `msg.topic`.
 
-Setting **msg.payload** to `DEL` delete any sprites - leaving the background.
+Setting `msg.payload` to `DEL` delete any sprites - leaving the background.
 
-Setting **msg.payload** to `CLS` will clear the display to off and delete any sprites.
+Setting `msg.payload` to `CLS` will clear the display to off and delete any sprites.
 
-The overall brightness may be set by setting **msg.payload** to `brightness,nn`, where `nn` is 0 to 100.
+The overall brightness may be set by setting `msg.payload` to `brightness,nn`, where `nn` is 0 to 100.
 
-The rotation may be set by setting ••msg.payload•• to 'rotate,rr', where 'rr' is 0, 90, 180 or 270.
+The rotation may be set by setting `msg.payload` to 'rotate,rr', where 'rr' is 0, 90, 180 or 270.
diff --git a/hardware/unicorn/package.json b/hardware/unicorn/package.json
index 7d2e75e4..cead7d7f 100644
--- a/hardware/unicorn/package.json
+++ b/hardware/unicorn/package.json
@@ -1,6 +1,6 @@
 {
     "name"          : "node-red-node-pi-unicorn-hat",
-    "version"       : "0.0.5",
+    "version"       : "0.0.6",
     "description"   : "A Node-RED node to output to a Raspberry Pi Unicorn HAT from Pimorini.",
     "dependencies"  : {
         "pngjs": "2.2.*"
diff --git a/hardware/wemo/60-wemo.html b/hardware/wemo/60-wemo.html
index b75c3ab1..cec3bd61 100644
--- a/hardware/wemo/60-wemo.html
+++ b/hardware/wemo/60-wemo.html
@@ -27,7 +27,7 @@
 </script>
 
 <script type="text/x-red" data-help-name="wemo out">
-    <p>Wemo output node. Expects a <b>msg.payload</b> with either 1/0, on/off or true/false.</p>
+    <p>Wemo output node. Expects a <code>msg.payload</code> with either 1/0, on/off or true/false.</p>
     <p>It doesn't yet do any ip address discovery of the wemo devices.</p>
 </script>
 
@@ -65,7 +65,7 @@
 </script>
 
 <script type="text/x-red" data-help-name="wemo in">
-    <p>Wemo input node. Creates a <b>msg.payload</b> with either 1, 0, nc (no change), or na (not available).</p>
+    <p>Wemo input node. Creates a <code>msg.payload</code> with either 1, 0, nc (no change), or na (not available).</p>
     <p>It doesn't yet do any ip address discovery of the wemo devices.</p>
 </script>
 
diff --git a/hardware/wemo/README.md b/hardware/wemo/README.md
index 32214701..8b9b4ab2 100644
--- a/hardware/wemo/README.md
+++ b/hardware/wemo/README.md
@@ -6,7 +6,7 @@ A pair of <a href="http://nodered.org" target="_new">Node-RED</a> nodes to contr
 Install
 -------
 
-Run the following command in the root directory of your Node-RED install
+Run the following command in your Node-RED user directory - typically `~/.node-red`
 
     npm install node-red-node-wemo
 
@@ -16,11 +16,11 @@ Usage
 
 It doesn't yet do any ip address discovery of the wemo devices.
 
-###Wemo output node.
+### Wemo output node.
 
-Expects a **msg.payload** with either 1/0, on/off or true/false.
+Expects a `msg.payload` with either 1/0, on/off or true/false.
 
 
-###Wemo input node.
+### Wemo input node.
 
-Creates a **msg.payload** with either 1, 0, nc (no change), or na (not available).
+Creates a `msg.payload` with either 1, 0, nc (no change), or na (not available).
diff --git a/hardware/wemo/package.json b/hardware/wemo/package.json
index 34de53c9..5d31c60a 100644
--- a/hardware/wemo/package.json
+++ b/hardware/wemo/package.json
@@ -1,6 +1,6 @@
 {
     "name"          : "node-red-node-wemo",
-    "version"       : "0.0.2",
+    "version"       : "0.0.3",
     "description"   : "A Node-RED node to control a Belkin Wemo set of devices.",
     "dependencies"  : {
         "wemo"   : "0.2.*"