Add chapter basic (comments, syntax, ...)

SamyPesse · SamyPesse · commit d26488e1b461 · 2014-04-01T22:51:39.000-07:00
diff --git a/README.md b/README.md
@@ -3,4 +3,7 @@ Learn Javascript
 
 This book will teach you the basics of programming and Javascript. Whether you are an experienced programmer or not, this book is intended for everyone who wishes to learn the JavaScript programming language.
 
-JavaScript (*JS for short*) is the programming language that enables web pages to respond to user interaction beyond the basic level.
+JavaScript (*JS for short*) is the programming language that enables web pages to respond to user interaction beyond the basic level. It was been created in 1995, and is today one of the most famous and used programing languages.
+
+
+**Note:** This book was been generated using [GitBook](http://www.gitbook.io) and is open source, feel free to contribute or signal issues on [GitHub](https://github.com/GitbookIO/javascript).
diff --git a/SUMMARY.md b/SUMMARY.md
@@ -1,7 +1,9 @@
 # Summary
 
-* [Variables](variables/README.md)
-    * [Types](variables/types.md)
+* [Basics](basics/README.md)
+    * [Comments](basics/comments.md)
+    * [Variables](basics/variables.md)
+    * [Types](basics/types.md)
 * [Numbers](numbers/README.md)
     * [Creation](numbers/create.md)
     * [Basic Operators](numbers/operators.md)
diff --git a/basics/README.md b/basics/README.md
@@ -0,0 +1,19 @@
+# Basics about Programming
+
+In this first chapter, we'll learn the basics of programming and the Javascript language.
+
+Programming means writting code. Much like a book is made up of chapters, paragraphs, sentences, phrases, words and finally punctuation and letters, so too is a program broken down into smaller and smaller components. For now, the most important is a statement. A statement is analogous to a sentence in a book. On its own, it has structure and purpose, but without the context of the other statements around it, it isn't that meaningful.
+
+A statement is more casually (and commonly) known as a *line of code*. That's because statements tend to be written on individual lines. As such, programs are read from top to bottom, left to right. You might be wondering what code (also called source code) is. That happens to be a broad term which can refer to the whole of the program or the smallest part. Therefore, a line of code is simply a line of your program.
+
+Here is a simple example:
+
+```js
+var hello = "Hello";
+var world = "World";
+
+// Message equals "Hello World"
+var message = hello + " " + world;
+```
+
+This code can be executed by another program called an *interpreter* taht will read the code, and execute all the statements in teh right order.
diff --git a/basics/comments.md b/basics/comments.md
@@ -0,0 +1,43 @@
+# 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.
+
+In Javascript, comments can be written in 2 different ways:
+
+* Line starting with `//`:
+
+```js
+// This is a comment, it will be ignored by the interpreter
+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:
+
+```js
+/*
+This is a multi-lines comment,
+it will be ignored by the interpreter
+*/
+var a = "this is a variable defined in a statement";
+```
+
+
+---
+
+Mark the all editor content as a comment
+
+```js
+Mark me as a comment
+or I'll throw an error
+```
+
+```js
+/*Mark me as a comment
+or I'll throw an error*/
+```
+
+```js
+assert(true);
+```
+
+---
diff --git a/basics/types.md b/basics/types.md
diff --git a/basics/variables.md b/basics/variables.md
@@ -1,6 +1,6 @@
 # Variables
 
-The first step towards understanding programming is looking back at algebra. If you remember from school, algebra starts with writing terms such as the following.
+The first step towards really understanding programming is looking back at algebra. If you remember from school, algebra starts with writing terms such as the following.
 
 ```
 3 + 5 = 8
diff --git a/comments/README.md b/comments/README.md
