edit content wording

Author: Stephen Lee

01_Introduction to JavaScript Development/00_Dynamic HTML/00_What is DHTML?/00_.md

@@ -1,14 +1,3 @@
-What is DHTML?
-- **Dynamic HTML** (**DHTML**)
-  - Makes possible a Web page to react and change in response to the user’s actions
-- DHTML consists of HTML + CSS + JavaScript
+DHTML, or Dynamic HTML, consists of HTML, CSS, and JavaScript. DHTML makes it possible for a web page to react and change in response to the user's actions.
 
-DTHML = HTML + CSS + JavaScript:
-
-- **HTML** defines Web sites **content** through **semantic** tags (headings, paragraphs, lists, …)
-- **CSS** defines **'rules**' or **'styles**' for **presenting** every aspect of an HTML document
-  - **Font** (family, size, color, weight, etc.)
-  - **Background** (color, image, position, repeat)
-  - **Position** and **layout** (of any object on the page)
-- **JavaScript** defines dynamic behavior
-  - **Programming logic** for interaction with the user, to handle events, etc.
+HTML defines Web sites content through semantic tags (headings, paragraphs, lists, …) while CSS defines 'rules' or 'styles' for presenting every aspect of an HTML document. These include font size, font color, background color, background position, layout, etc. JavaScript defines dynamic behavior through programming functions for interaction with the user and to handle events such as clicking a button.

01_Introduction to JavaScript Development/01_Intro to JavaScript/00_Why use JavaScript?/00_.md

@@ -1,9 +1,7 @@
-**JavaScript** is a front-end scripting language developed by Netscape for dynamic content:
-  - Lightweight, but with limited capabilities
-  - Can be used as object-oriented language
-  - Embedded in your HTML page
-  - Interpreted by the Web browser
+JavaScript is a front-end scripting language developed by Netscape for dynamic content. JavaScript is:
+  - lightweight, but with limited capabilities
+  - can be used as object-oriented language
+  - embedded in your HTML page
+  - interpreted by the Web browser
 
-**Client-side**, **mobile** and **desktop** technology:
-- Simple and flexible
-- Powerful to manipulate the DOM
+JavaScript's client-side, mobile and desktop technology is simple and flexible. It can access and edit all the elements of an HTML document using the HTML DOM.

01_Introduction to JavaScript Development/01_Intro to JavaScript/01_JavaScript Advantages/00_.md

@@ -1,7 +1,7 @@
-**JavaScript** allows interactivity such as:
+JavaScript allows interactivity such as:
   - Implementing form validation
   - React to user actions, e.g. handle keys
-  - Changing an image on moving mouse over it
+  - Changing an image just by moving your mouse over it
   - Sections of a page appearing and disappearing
   - Content loading and changing dynamically
   - Performing complex calculations

01_Introduction to JavaScript Development/01_Intro to JavaScript/02_What Can JavaScript Do?/00_.md

@@ -1,9 +1 @@
-JavaScript can:
-- Can handle events
-- Can read and write HTML elements and modify the DOM tree
-- Can validate form data
-- Can access / modify browser cookies
-- Can detect the user's browser and OS
-- Can be used as object-oriented language
-- Can handle exceptions
-- Can perform asynchronous server calls (AJAX)
+JavaScript can handle events and read/write elements and modify the DOM tree. It can also be used to validate form data and access/modify browser cookies. Other benefits include detecting the user's browser and OS. As mentioned previously, it can handle exceptions and perform asynchronous server calls using AJAX.

01_Introduction to JavaScript Development/01_Intro to JavaScript/03_JavaScript Engines/00_.md

@@ -1,11 +1 @@
-Depends on Browser:
-  - V8 in Chrome
-  - Chakra in IE
-  - Spidermonkey in Firefox
-  - JavaScriptCore for Safari
-
-Services:
-  - Memory Management / GC
-  - Just-in-Time Compilation
-  - Type System
-  - etc.
+There are different JavaScript Engine depending on the browser you use. For example, Chrome has V8, Internet Explorer has Chakra, FireFox as Spidermonkey, and Safari has JavaScriptCore. All of these JavaScript engines helps your browser by supporting memory management, garbage collection, in-time compilation and much more.

01_Introduction to JavaScript Development/01_Intro to JavaScript/04_Using JavaScript Code/00_.md

@@ -1,7 +1 @@
-The JavaScript code can be placed in:
-  - `<script>` tag in the head
-  - `<script>` tag in the body - not recommended
-  - External files, linked via `<script>` tag the head
-    - Files usually have **.js** extension
-    - Highly recommended
-    - The **.js** files get cached by the browser
+When using JavaScript with HTML, the JavaScript code can be placed in a `<script>` tag in the header or as a `<script>` tag in the body (not recommended). An alternative will be to linking it to a `<script>` tag in the header as an external file. This is highly recommended as some javascript code can go beyond 100-200 lines. These files usually have a .js extension and will get cached by the browser. The code below contains a simple program that print "Hello" to the console in the terminal.

01_Introduction to JavaScript Development/01_Intro to JavaScript/05_When is JavaScript Executed?/00_.md

@@ -1,7 +1,3 @@
-JavaScript code is executed during the page loading or when the browser fires an event:
-  - All statements are executed at page loading
-  - Some statements just define functions that can be called later
-  - No compile time checks
+JavaScript code is executed during page loading or when the browser fires an event. All the statements in JavaScript are executed at page loading, even if most of the statements are just functions that are not used until the user interacts wit the site. 
 
-Function calls or code can be attached as "event handlers" via tag attributes:
-  - Executed when the event is fired by the browser
+Function calls or code can be attached as "event handlers" via tag attributes that are then executed when the event is fired by the browser. For example, clicking a button could screen could trigger a piece of code in the JavaScript to do something. (i.e. change the color of the button). The code below has a method called `alert` that will send an alert message to the browser when it is run.

01_Introduction to JavaScript Development/02_Node.js Overview/00_JavaScript in the console/00_.md

@@ -1,4 +1 @@
-**Node.js** is a server-side platform that uses JavaScript
-  - Runs the V8 JS interpreter
-  - Allows creating end-to-end apps with JavaScript
-  - Usable to test & learn JavaScript Syntax
+Node.js is a server-side platform that uses JavaScript. It is an cross-platform JavaScript run-time environment that executes JavaScript code outside the browser. Node.js is built on Chrome's V8 JavaScript Engine and helps create end-to-end apps with JavaScript. You can use Node.js to test & learn JavaScript Syntax locally on your terminal.

01_Introduction to JavaScript Development/02_Node.js Overview/01_Installing Node.js on Windows/00_.md

@@ -1,15 +1,23 @@
-Visit the Node.js website: https://nodejs.org/
-- **Next** -> **Next** -> **Next** -> …
-- Make sure Node.js is added to **PATH**
-- Node.js is installed on the machine and can be used through the CMD/Terminal
-- In the CMD/Terminal run `node -v`
-  - Should return the version, if node is installed and working
-
-- Go to **Computer** -> **Properties**
-- Go to **Advanced system settings**
-- Go to **Advanced** -> **Environment Variables**
-- Go to **System Variables** -> **Path** -> **Edit**
-- Add to the end:
+Steps for installing Node.js on Windows:
+
+1.  Visit the Node.js website: https://nodejs.org/
+
+2. Download Node.js to your computer
+
+3. Make sure Node.js is added to PATH
+
+4. In the CMD/Terminal run `node -v`, which should return the version of you node if node is installed
+
+5. Go to Computer -> Properties
+
+6. Go to Advanced system settings
+
+7. Go to Advanced -> Environment Variables
+
+8. Go to System Variables -> Path -> Edit
+
+Add to the end of the file:
+
 ```
 ;C:\Program Files\nodejs\
 ```

01_Introduction to JavaScript Development/02_Node.js Overview/02_Adding Node.js to Path on Linux and OS X/00_.md

@@ -1,7 +1,3 @@
-It probably already exists.
+Installing Node.js to your Mac/Linux:
 
-Otherwise
-  - Open `~/.bashrc` (or `~/.zshrc`)
-  - Find the Node.js path
-    - Usually it is `/usr/bin/node`
-  - Add the Node.js path to `~/.bashrc`
+Node.js probably already exists on your Mac/Linux. If not, go to the Node.js site and download it there. If you have an older version of Node.js, also go to the website to download the latest stable release. If you cannot find the Node.js even after installing it, check your bash profile and make sure Node.js exists as a PATH variable.

01_Introduction to JavaScript Development/03_JavaScript Syntax/00_Syntax/00_.md

@@ -1,7 +1,11 @@
-The **JavaScript** syntax is similar to **C#**
+If you've ever learned C-Sharp, JavaScript syntax shouldn't be a problem for you. Otherwise, the list below gives you a rough idea of the syntax used in JavaScript.
+
+Syntax used for:
+
   - Operators (`+`, `*`, `=`, `!=`, `&&`, `++`, …)
-  - Variables (typeless)
+  - Variables (`var myVariable = 5`)
   - Conditional statements (`if`, `else`)
   - Loops (`for`, `while`)
   - Arrays (`my_array[]`) and associative arrays (`my_array['abc']`)
-  - Functions (can return value)
+  - Functions (`function myFunction{}`)
+    - can return value

01_Introduction to JavaScript Development/04_Standard Javascript Objects/00_Pop-up Boxes/00_.md

@@ -1,7 +1 @@
-Standard Pop-up Boxes:
-- Alert box with text and **[OK]** button
-  - Just a message shown in a dialog box:
-- Confirmation box
-  - Contains text, **[OK]** button and **[Cancel]** button:
-- Prompt box
-  - Contains text, input field with default value:
+There are three standard pop-up boxes, alert box, confirmation box, and prompt box. The alert box contains text and an "OK" button that shows a message in a dialog box. The confirmation box contains text, an "OK" button, and a "cancel" button. The prompt box contains text and an input field with a default value. Run the program below to see all three pop-up boxes one by one.

01_Introduction to JavaScript Development/04_Standard Javascript Objects/01_Built-In Browser Objects/00_.md

@@ -7,4 +7,6 @@ The browser provides some read-only data via:
   - `screen`
     - Holds the user’s display properties
   - `browser`
-    - Holds information about the browser
+    - Holds information about the browser
+
+These objects will only be used if you were to work with HTML and websites.

01_Introduction to JavaScript Development/04_Standard Javascript Objects/02_The Math Object/00_.md

@@ -1 +1,3 @@
-The `Math` object provides some mathematical functions.
+The `Math` object provides some mathematical functions such as rounding, exponents, sine, cosine, tangent, etc. These functions may or may not benefit you depending on the program you are writing and the intended use. 
+
+The functions `Math.random()` and `Math.floor` are shown below in the sample code to illustrate a random number generator for numbers in between 1 and 100. There are many other functions you can use in the Math Object that are documented online at your disposal. Make sure you always call the function using `Math.someMethod()`, not just `someMethod()`. You will not be able to use the functions in the Math Object without referencing it in your code. Play around with the random number generator below and try to print random numbers in between 50 to 100 instead of 1 to 100.

01_Introduction to JavaScript Development/04_Standard Javascript Objects/03_The Date Object/00_.md

@@ -1 +1,5 @@
-The `Date` object provides date / calendar functions:
+The `Date` object provides date / calendar functions as shown below. The default output of the `Date()` looks something like this:
+
+Fri Aug 17 2018 18:16:34 GMT+0800 (Hong Kong Standard Time)
+
+The code below shows three examples of the use of Date object. The second and third example uses `setTimeOut()` and `setTimeInterval()`, two advanced methods that will help you continuously run a function over a certain interval or to create your own timer tell the program when to run a certain function. We will not go in depth with the two methods, but feel free to research these two methods if you are interested as it could potentially help you in the future if you ever work with websites.

01_Introduction to JavaScript Development/05_Debugging in JavaScript/00_Debugging/00_.md

@@ -1,8 +1,3 @@
-Modern browsers have **JavaScript** console where errors in scripts are reported
-  - Errors may differ across browsers
+Debugging is the act of identifying and fixing errors in your program. Modern browsers have JavaScript console where errors in scripts are reported. This can be found via right clicking the site and selecting "Inspect Element". You will then see a console screen where errors are printed (if any).
 
-Several tools to debug **JavaScript**
-  - Microsoft Script Editor
-    - Add-on for Internet Explorer
-    - Supports breakpoints, watches
-    - **JavaScript** statement **debugger**; opens the script editor
+Errors may differ across browsers as each browser has their own JavaScript Engine. There are several tools you can use to debug JavaScript. Microsoft Script Editor is a convenient add-on for Internet Explorer that supports breakpoints and watches for debugging. If you are using other browsers, debugging it locally own your computer or searching for an add-on or a online text editor is how you would approach debugging. Firefox has Firebug, which we will talk about in the next section.

01_Introduction to JavaScript Development/05_Debugging in JavaScript/01_Firebug/00_.md

@@ -1,7 +1,3 @@
-Firefox add-on for debugging JavaScript, CSS, HTML
-  - Supports breakpoints, watches, **JavaScript** console editor
-  - Very useful for CSS and HTML too
-    - You can edit all the document real-time: CSS, HTML, etc
-    - Shows how CSS rules apply to element
-  - Shows Ajax requests and responses
-  - **Firebug** is written mostly in **JavaScript**
+Firefox has a convenient add-on for debugging JavaScript, CSS, HTML. Firebug supports breakpoints, watches, and has a JavaScript console editor for JavaScript debugging.
+
+You can edit the HTML, CSS, and JavaScript documents real-time and to see how the three different pieces of code interact with each other to create the site. For more advanced users, Firebug also shows Ajax requests and responses. Interestingly enough, Firebug is written mostly in JavaScript.

01_Introduction to JavaScript Development/05_Debugging in JavaScript/02_Debugging Node.js/00_.md

@@ -1,12 +1,11 @@
-**JavaScript** can also be debugged with **Node.js**
-  - Open Terminal/CMD
-  - Run
-```bash
-npm install -g node-inspector
+As mentioned previously, JavaScript can also be debugged locally with Node.js. Node.js has it's own debugger that can be called using the `inspect` keyword. Here's how you will debug a JavaScript file:
+
+1. Open Terminal/CMD
+2. Navigate to the folder of the file to debug
+3. Run 
 ```
-  - In CMD/Terminal, navigate to the folder of the file to debug
-  - Run
-```bash
-node-debug FILE_TO_DEBUG
+node inspect filename.js
 ```
-  - A browser opens with the code, and it can be debugged
+4. You will then see the debugging screen. This is what you will be using later. Type control c twice and exit the debugger.
+5. Go back to your JavaScript file and add the statement `debugger;` to create a breakpoint
+6. Run step 3 again and a breakpoint will occur

01_Introduction to JavaScript Development/05_Debugging in JavaScript/03_JavaScript Console Object/00_.md

@@ -1,7 +1,7 @@
-The `console` object exists only if there is a debugging tool that supports it
-  - Used to write log messages at runtime
+If you are editing JavaScript locally or through node.js, you can also use the `console` object. As shown in previous examples, `console.log` prints something to the console when called. If you are familiar with Java, it's just like debugging with the `System.out.print()` statement.
+
+You can use this function to write log messages at runtime to identify where the error in the program occurs. Below are some methods of the console object:
 
-Methods of the `console` object:
   - `debug(message)`
   - `info(message)`
   - `log(message)`