try to make Pi install even more clear.

Author: Dave Conway-Jones

docs/hardware/beagleboneblack.md

@@ -4,10 +4,10 @@ title: Running on BeagleBone Boards
 ---
 
 We recommend using the latest Debian 9 Stretch based SD card images - from
- <a href="https://beagleboard.org/latest-images" target="_new">beagleboard.org</a>.
+ <a href="https://beagleboard.org/latest-images" target="bbb">beagleboard.org</a>.
 
-The 4GB images for BeagleBone boards already have Node-RED pre-installed and set to auto-start, so you can just boot
-and point your browser at your BeagleBone, port 1880.
+The 4GB images for BeagleBone boards already have Node-RED pre-installed and set to auto-start,
+so you can just boot and point your browser at your BeagleBone, port 1880.
 
 The 2GB console version suitable for flashing to older eMMC versions of the BBB is not recommended but can be
 installed as per the manual installation instructions below.
@@ -46,8 +46,9 @@ This should also restart the Node-RED service - but you will need to refresh any
 
 If you are on the 2017 Debian 9.2 version you may need to run `sudo apt full-upgrade` first.
 
-**Note**: Do NOT use the Raspberry Pi / Debian upgrade script (`update-nodejs-and-nodered`) as it will re-install
-both Node.js and Node-RED in different locations and will conflict with and break the existing systemd configuration files.
+**Note**: Do NOT use the Raspberry Pi / Debian upgrade script (`update-nodejs-and-nodered`) as
+it will re-install both Node.js and Node-RED in different locations and will conflict with and
+break the existing systemd configuration files.
 
 ---
 
@@ -85,10 +86,10 @@ software certificates date checks to be valid.
 
 #### Updating Node.js
 
-We recommend using Node.js LTS 6.x or 8.x
+We recommend using Node.js LTS 8.x or 10.x
 
     sudo apt-get install curl
-    curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
+    curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
     sudo apt-get install -y build-essential nodejs
     hash -r
 

docs/hardware/raspberrypi.md

@@ -3,9 +3,11 @@ layout: default
 title: Running on Raspberry Pi
 ---
 
-From June 2018 Node-RED can be installed from the Pi Menu - Preferences - Recommended Software application installed on the Raspbian SD card image that can be downloaded from [RaspberryPi.org](https://www.raspberrypi.org/downloads/raspbian/). If installed in this manner it can be upgraded either by using `sudo apt-get upgrade` or using the script below.
-Once the script below has been run, you should upgrade by re-running the script.
-If you decide to stick with apt to install npm then you must upgrade it to the latest by `sudo npm i -g npm` before adding any extra nodes.
+The recommended way to install Node-RED on Pi is to use our script below, however Node-RED can be installed from the Recommended Software application installed on the Raspbian SD card image that can be downloaded from [RaspberryPi.org](https://www.raspberrypi.org/downloads/raspbian/). If installed in this manner it is recommended to upgrade by using the script below.
+
+If you decide to not to use the script, and stick with apt to install Node-RED, then you **must** manually install npm and then upgrade it to the latest level by `sudo apt-get install npm && sudo npm i -g npm` before installing any extra nodes.
+
+You can upgrade Node-RED by re-running the script.
 
 ### Install / Upgrade
 
@@ -16,8 +18,6 @@ already installed, you can install or upgrade using the Node-RED upgrade script
 
 On really minimal Debian installs you may want to `sudo apt-get install build-essential` before running the script so that the serialport builds and installs OK. This is optional.
 
-**Note:** Once you have used this script to upgrade, you cannot use apt-get to upgrade the pre-installed version of Node-RED.
-
 #### Script Description
 
 Nodes can be now be managed via the built in palette manager. However the default Pi install pre-loads some