Fix typos in basics/comments.md

Aaron O'Mullan · Aaron O'Mullan · commit 01aac5313c45 · 2014-04-02T19:06:29.000-07:00
diff --git a/basics/comments.md b/basics/comments.md
@@ -1,6 +1,6 @@
 # Comments
 
-Comments are statements that will not be executed by the interpreter, comments are used to mark anotations for others programmers or to make it easy to understand your code in the future.
+Comments are statements that will not be executed by the interpreter, comments are used to mark anotations for others programmers or small descriptions of what your code does, thus making it easier for others to understand what your code does.
 
 In Javascript, comments can be written in 2 different ways:
 
@@ -11,11 +11,11 @@ In Javascript, comments can be written in 2 different ways:
 var a = "this is a variable defined in a statement";
 ```
 
-* Section of code starting by `/*`and finishing by `*/`, this method is used for multi-lines comments:
+* Section of code starting with `/*`and ending with `*/`, this method is used for multi-line comments:
 
 ```javascript
 /*
-This is a multi-lines comment,
+This is a multi-line comment,
 it will be ignored by the interpreter
 */
 var a = "this is a variable defined in a statement";
@@ -24,11 +24,13 @@ var a = "this is a variable defined in a statement";
 
 ---
 
-Mark the all editor content as a comment
+Mark the editor's contents as a comment
 
 ```js
+
 Mark me as a comment
 or I'll throw an error
+
 ```
 
 ```js
