muses-code-js
diff --git a/‎js/level1.js‎
Lines changed: 19 additions & 18 deletions b/‎js/level1.js‎
Lines changed: 19 additions & 18 deletions
diff --git a/‎js/level3.js‎
Lines changed: 1 addition & 1 deletion b/‎js/level3.js‎
Lines changed: 1 addition & 1 deletion
@@ -4,34 +4,35 @@
     Comments
     ========
 
-    Let's start with comments. Comments are notes that people can read and
-    computers will ignore.
+    Let's start with comments. This is a comment. Comments are notes that people
+    can read and computers will ignore.
 
     They will help us to guide you through the JavaScript introduction
     journey.
 */
 
+// Single line comments look like this.
+
 /*
     Multi-line comments look like this.
+    When you are writing actual code, put it outside these comment blocks,
+    so the computer doesn't ignore them.
 */
 
-// Single line comments look like this.
-
-
 /*
     Let's start with getting your code on the screen.
 
     There are a few ways you can do it and we will look into a few of them:
 
-    * alert('Hello girls!');
+    alert('Hello girls!');
     ** This line of code will pop-up a small window in your browser with the text
     'Hello girls!' in it, but you need to refresh the opened page first.
 
-    * console.log('Hello World!');
+    console.log('Hello World!');
     ** This line of code will print 'Hello World!' to the browser's console.
 
     P.S: To see the browser's console you can right click on the window of your
-    browser(Chrome, Firefox etc) and select 'Inspect' or 'Inspect element'.
+    browser (Chrome, Firefox etc) and select 'Inspect' or 'Inspect element'.
     After that a console will appear on the bottom right side of the page.
 */
 
@@ -75,9 +76,10 @@
     As you can notice, we can give different types of values to our variables -
     strings, numbers, booleans etc.
 
-    A string is a set of characters, word(s) or phrase(s) that we wrap in quotes,
-    see 'hello world!' in the previous task.
-    Numbers - either integers or floats(decimals)
+
+    Strings - set of characters, word(s), or phrases that we wrap in quotes, like
+              'hello world!'
+    Numbers - either integers or floats(decimals). Not wrapped in quotes
     Boolean - it represents logical values - True or False
 */
 
@@ -123,8 +125,7 @@
     alert(sumOfNumbers);
 
     This will pop-up an alert box with the number 4.
-
-    (You can see a full list of )
+    TIP: Note how we didn't put 1 and 3 in quotes, because they are numbers.
 */
 
 // TODO: Create 3 variables:
@@ -143,9 +144,9 @@
     Functions
     =========
 
-    A function is a reusable piece of code, an action that you want to do.
-    It takes some input (arguments), does some manipulation on it and returns
-    the output. Use the keyword 'return' to define the return value.
+    A function is like a blueprint, an action that you want to do.
+    It takes some input variables called arguments, does some manipulation on
+    it and returns the output. Use the keyword 'return' to define the return value.
 
     To create a function use the following format:
 
@@ -303,7 +304,7 @@
 
 
 ///////////////////////////////////////////////////////////////////////////
-//Congratulations! You have finished Part 1 of JavaScript Basics!        //
+// Congratulations! You have finished Part 1 of JavaScript Basics!       //
 // Stand up, stretch your legs, and celebrate your achievement.          //
-//The next step will be following the instructions in the level2.js file.//
+// The next step will be following the instructions in the level2.js file//
 ///////////////////////////////////////////////////////////////////////////
@@ -261,7 +261,7 @@
 
     Example:
 
-    var pageNode = document.querySelector('body')[0];
+    var pageNode = document.querySelector('body');
     var newParagraph = document.createElement('p');
     var paragraphText = document.createTextNode('Squee!');
     newParagraph.appendChild(paragraphText);