correct documentation, add target for running an IDE release

Author: SillyFreak

INSTALL.md

@@ -5,7 +5,7 @@
 ## Automated installation with HedgehogBundle (recommended)
 
 HedgehogBundle allows a very simple installation of the Hedgehog platform, the IDE can be installed via a single command.
-After cloning or downloading the bundle to the controller, simple enter the following two commands in the `HedgehogBundle` directory:
+After cloning or downloading the bundle to the controller, simply enter the following two commands in the `HedgehogBundle` directory:
 
 ```bash
 $ cd ide
@@ -18,25 +18,38 @@ Now you are all set! The IDE should be running on port 80 of your controller and
 ## Manual installation (only for advanced users)
 
 In order to install the Hedgehog IDE manually on the Hedgehog controller, you first need to install Node.JS.
-To do so, open a terminal connection to your Hedgehog's Raspberry Pi, and type the following.
+To do so, open a terminal connection to your Hedgehog's Raspberry Pi.
+We recommend NVM for installing a node version:
+
+```bash
+$ sudo aptitude -y install libssl-dev libzmq-dev libcurl4-gnutls-dev
+$ curl -L https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash
+
+$ export NVM_DIR="$HOME/.nvm"
+$ . "$NVM_DIR/nvm.sh"
+$ nvm install 8.14.0
+```
+
+Alternatively, download and install a distribution manually:
 
 ```bash
-$ wget https://nodejs.org/dist/v8.9.4/node-v8.9.4-linux-armv6l.tar.xz
-$ tar -xvf node-v8.9.4-linux-armv6l.tar.xz
-$ sudo cp -R node-v8.9.4-linux-armv6l/* /usr/local/
 $ sudo apt install libssl-dev libzmq-dev libcurl4-gnutls-dev
+$ wget https://nodejs.org/dist/v8.14.0/node-v8.14.0-linux-armv6l.tar.xz
+$ tar -xvf node-v8.14.0-linux-armv6l.tar.xz
+$ sudo cp -R node-v8.14.0-linux-armv6l/* /usr/local/
 ```
 
 Now you have the following options:
 - install an official release of the Hedgehog IDE
-- build the IDE from source for development
-- build the IDE from source and make your own production version
+- run the IDE in development mode
+- build the IDE from source and run it
+- build the IDE from source and prepare a release
 
 In each case, you will need to apply the correct configuration and set the `environment` option correctly.
 
 ### Installing a release
 
-Simply download the latest release to your controller:
+Simply download and unpack the latest release to your controller:
 
 ```bash
 $ wget https://github.com/PRIArobotics/hedgehog-ide/releases/download/v1.3.0/hedgehog-ide-1.3.0-linux-armv7l.tar.gz
@@ -58,22 +71,34 @@ $ npm install
 ### development mode
 
 If you plan to work on the IDE itself and test changes frequently, this is what you want.
-The command will start a server and apply updates to any files automatically
+The command will start a server and apply updates to any files automatically.
 
 ```bash
 $ npm run develop
 ```
 
 Your configuration needs to use `environment: 'debug',`.
 
-### production mode
+### building the IDE
+
+With these commands, you build the IDE once and can then run it again multiple times.
+Changes to the source files will not affect the IDE until you rebuild.
+
+```bash
+$ npm run build
+$ npm run start
+```
+
+Your configuration needs to use `environment: 'production',`.
+
+### preparing a release
 
-If you want to build an optimized production build of the IDE, this is the right way.
-The commands here will first build a Hedgehog IDE release, and then start the webserver.
+To release a new version of the IDE, use these commands.
+Compared to `build`, `release` will apply some pruning to reduce size,
+and collect all files into the `release/` directory for packaging.
 
 ```bash
 $ npm run release
-$ npm start
 ```
 
 Your configuration needs to use `environment: 'production',`.

README.md

@@ -10,7 +10,7 @@ See [INSTALL.md](INSTALL.md) for setup & installation instructions.
 
 ## Development
 ### Tools
-For following tools are used for development the Hedgehog IDE.
+The following tools are used for development the Hedgehog IDE.
 Thus, if you want to start working on the IDE, you will need to install them first.
 - Dependency Management: [NPM](https://www.npmjs.com/)
 - Build Automation: [Grunt](http://gruntjs.com/)

package.json

@@ -7,10 +7,10 @@
     "test": "nyc mocha --require ts-node/register --reporter spec --check-leaks test/**/*.spec.ts",
     "coveralls": "nyc report --reporter=text-lcov | ./node_modules/.bin/coveralls",
     "develop": "./node_modules/grunt/bin/grunt",
-    "build": "./node_modules/grunt/bin/grunt build",
-    "release": "./node_modules/grunt/bin/grunt release",
     "gsl-blockly": "python -m gsl_blockly",
-    "start": "node build/src/server/server.js"
+    "build": "./node_modules/grunt/bin/grunt build",
+    "start": "node build/src/server/server.js",
+    "release": "./node_modules/grunt/bin/grunt release"
   },
   "repository": {
     "type": "git",