add notes on requiring some javascript, modifying objects (#70)

* add notes on requiring some javascript, modifying objects

* added another primer link

* Keep only link to MDN

* JavaScript not Javascript

Author: mblackstock

docs/configuration.md

@@ -17,6 +17,10 @@ Node-RED includes a default `settings.js` file that will be used in absence of a
 user-provided settings file. It can also be used as a starting point for creating
 your own settings file. It can be seen on GitHub [here](https://github.com/node-red/node-red/blob/master/settings.js).
 
+<div class="doc-callout">
+<em>Note</em>:  The <code>settings.js</code> file exports a <em>JavaScript object</em>.  To configure Node-RED you should understand how to modify a JavaScript object by adding new or modifying existing key/value pairs.
+</div>
+
 When [embedded](embedding), they are passed in the call to `RED.init()`.
 However, when run in this mode, certain properties are ignored and are left to
 the embedding application to implement.

docs/user-guide/index.md

@@ -6,7 +6,6 @@ title: User Guide
 
 There's lots more to write in this guide, we're just getting started.
 
-
 - [Configuring Node-RED](/docs/configuration)
 - [Security](/docs/security)
 - [Logging](/docs/user-guide/logging)
@@ -16,6 +15,13 @@ There's lots more to write in this guide, we're just getting started.
 - [Working with messages](/docs/user-guide/messages)
 - [Embedding into an existing app](/docs/embedding)
 
+<div class="doc-callout">
+<em>Note</em>:  Parts of the user guide assume the reader is somewhat familiar with
+<strong>JavaScript</strong> (not Java).  There are many online resources to get up
+to speed with JavaScript. Mozilla, for example, has a good
+<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript">re-introduction to JavaScript</a>
+that should get you headed in the right direction.
+</div>
 
 ### Other places to get help
 

docs/user-guide/projects/index.md

@@ -38,12 +38,18 @@ enabled in the settings file.
 To enable the projects feature, edit your `settings.js` file and add the following
 option within the `module.exports` block and restart Node-RED.
 
+<div class="doc-callout">
+<em>Note</em>:  The <code>settings.js</code> file exports a <em>JavaScript object</em>.
+To configure Node-RED you should understand how to modify a JavaScript object by adding
+new or modifying existing key/value pairs like the <code>editorTheme</code> below.
+</div>
+
 ```
    editorTheme: {
        projects: {
            enabled: true
        }
-   }
+   },
 ```
 
 The feature relies on having the `git` and `ssh-keygen` command line tools available.