javascript-tutorial · javascript-translate-bot · Mar 22, 2020 · Mar 22, 2020 · Mar 22, 2020 · Mar 23, 2020
diff --git a/1-js/01-getting-started/1-intro/article.md b/1-js/01-getting-started/1-intro/article.md
@@ -4,16 +4,25 @@ Hãy cùng xem Javascript có gì đặc biệt, chúng ta có thể hoàn thàn
 
 ## JavaScript là gì?
 
+<<<<<<< HEAD
 *JavaScript* ban đầu được tạo ra để *"make web pages alive"*.
+=======
+*JavaScript* was initially created to "make web pages alive".
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 
 Các chương trình trong ngôn ngữ này được gọi là *kịch bản (scripts)*. Chúng có thể được viết ngay trong HTML của trang web và chạy khi tải trang.
 
 Các tập lệnh (scripts) được cung cấp và thực thi dưới dạng văn bản thuần túy. Chúng không cần chuẩn bị hay biên dịch để có thể chạy được.
 
 Ở khía cạnh này, JavaScript rất khác với ngôn ngữ lập trình có tên là [Java](https://en.wikipedia.org/wiki/Java_(programming_language)).
 
+<<<<<<< HEAD
 ```smart header="Vì sao lại gọi là <u>Java</u>Script?"
 Khi Javascript được tạo ra, ban đầu nó có một cái tên khác: "LiveScript". Nhưng lúc này Java đang rất phổ biến, vì vậy người ta đã quyết định rằng đặt một ngôn ngữ mới là "em trai" của Java sẽ có ích.
+=======
+```smart header="Why is it called <u>Java</u>Script?"
+When JavaScript was created, it initially had another name: "LiveScript". But Java was very popular at that time, so it was decided that positioning a new language as a "younger brother" of Java would help.
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 
 Nhưng với sự phát triển của mình, JavaScript đã trở thành một ngôn ngữ hoàn toàn độc lập, với những đặc điểm kỹ thuật riêng của mình được gọi là [ECMAScript](http://en.wikipedia.org/wiki/ECMAScript), và bây giờ nó chẳng liên quan gì đến Java cả.
 ```
@@ -38,7 +47,11 @@ Engine khá phức tạp, tuy nhiên có thể hiểu đơn giản như sau:
 2. Tiếp theo nó chuyển đổi ("biên dịch") tập lệnh sang mã máy.
 3. Và sau đó mã máy chạy, khá nhanh.
 
+<<<<<<< HEAD
 Engine đều áp dụng tối ưu hóa ở các quy trình. Nó thậm chí còn xem tập lệnh được biên dịch khi đang chạy, phân tích dữ liệu chảy qua nó và áp dụng tối ưu hóa cho mã máy. Vì vậy tập lệnh có tốc độ khá nhanh sau khi được hoàn tất.
+=======
+The engine applies optimizations at each step of the process. It even watches the compiled script as it runs, analyzes the data that flows through it, and further optimizes the machine code based on that knowledge.
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 ```
 
 ## JavaScript có thể làm gì trong trình duyệt?
@@ -63,7 +76,11 @@ Nhiều tính năng của Javascript trong trình duyệt bị giới hạn vì
 
 Một số hạn chế có thể kể là:
 
+<<<<<<< HEAD
 - Javascript trên trang web không thể đọc/ghi các tập tin tùy ý, sao chép hoặc thực thi một chương trình. Nó cũng không có cách nào trực tiếp truy cập vào các hàm hệ thống của Hệ điều hành.
+=======
+- JavaScript on a webpage may not read/write arbitrary files on the hard disk, copy them or execute programs. It has no direct access to OS functions.
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 
     Nhiều trình duyệt hiện đại cho phép làm việc với tập tin, nhưng bị giới hạn và chỉ được truy cập nếu như người dùng thực hiện một hành động nhất định nào đó, ví dụ như "thả" các tập tin vào cửa sổ trình duyệt hoặc chọn chúng qua thẻ `<input>`.
 

diff --git a/1-js/01-getting-started/2-manuals-specifications/article.md b/1-js/01-getting-started/2-manuals-specifications/article.md
@@ -9,11 +9,19 @@ Nhưng với việc được chính thức hóa, ban đầu nó khá là khó hi
 
 Dự thảo mới nhất: <https://tc39.es/ecma262/>.
 
+<<<<<<< HEAD
 Để đọc về những tính năng mới nhất, bao gồm cả các tính năng gần như tiêu chuẩn (được gọi là "stage-3") xem tại: <https://github.com/tc39/proposals>.
+=======
+[The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information about JavaScript. It defines the language.
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 
 Ngoài ra, nếu bạn đang phát triển cho trình duyệt, thì có các thông số kỹ thuật khác được đề cập trong [phần thứ hai](info:browser-environment) của hướng dẫn.
 
+<<<<<<< HEAD
 ## Cẩm nang
+=======
+A new specification version is released every year. In-between these releases, the latest specification draft is at <https://tc39.es/ecma262/>.
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 
 - **Tài liệu tham khảo Javascript MDN (Mozilla)** là một tài liệu hướng dẫn với các ví dụ và thông tin khác gồm những thông tin chuyên sâu khá bổ ích về các hàm, phương thức (methods) etc.
 

diff --git a/1-js/01-getting-started/3-code-editors/article.md b/1-js/01-getting-started/3-code-editors/article.md
@@ -32,6 +32,7 @@ In practice, lightweight editors may have a lot of plugins including directory-l
 The following options deserve your attention:
 
 - [Atom](https://atom.io/) (cross-platform, free).
+- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free).
 - [Sublime Text](http://www.sublimetext.com) (cross-platform, shareware).
 - [Notepad++](https://notepad-plus-plus.org/) (Windows, free).
 - [Vim](http://www.vim.org/) and [Emacs](https://www.gnu.org/software/emacs/) are also cool if you know how to use them.

diff --git a/1-js/01-getting-started/4-devtools/article.md b/1-js/01-getting-started/4-devtools/article.md
@@ -29,10 +29,15 @@ The exact look of developer tools depends on your version of Chrome. It changes
 - Here we can see the red-colored error message. In this case, the script contains an unknown "lalala" command.
 - On the right, there is a clickable link to the source `bug.html:12` with the line number where the error has occurred.
 
-Below the error message, there is a blue `>` symbol. It marks a "command line" where we can type JavaScript commands. Press `key:Enter` to run them (`key:Shift+Enter` to input multi-line commands).
+Below the error message, there is a blue `>` symbol. It marks a "command line" where we can type JavaScript commands. Press `key:Enter` to run them.
 
 Now we can see errors, and that's enough for a start. We'll come back to developer tools later and cover debugging more in-depth in the chapter <info:debugging-chrome>.
 
+```smart header="Multi-line input"
+Usually, when we put a line of code into the console, and then press `key:Enter`, it executes.
+
+To insert multiple lines, press `key:Shift+Enter`. This way one can enter long fragments of JavaScript code.
+```
 
 ## Firefox, Edge, and others
 
@@ -50,12 +55,6 @@ Open Preferences and go to the "Advanced" pane. There's a checkbox at the bottom
 
 Now `key:Cmd+Opt+C` can toggle the console. Also, note that the new top menu item named "Develop" has appeared. It has many commands and options.
 
-```smart header="Multi-line input"
-Usually, when we put a line of code into the console, and then press `key:Enter`, it executes.
-
-To insert multiple lines, press `key:Shift+Enter`. This way one can enter long fragments of JavaScript code.
-```
-
 ## Summary
 
 - Developer tools allow us to see errors, run commands, examine variables, and much more.

diff --git a/1-js/02-first-steps/01-hello-world/1-hello-alert/index.html b/1-js/02-first-steps/01-hello-world/1-hello-alert/index.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+
+<body>
+
+  <script>
+    alert( "I'm JavaScript!" );
+  </script>
+
+</body>
+
+</html>
diff --git a/1-js/02-first-steps/01-hello-world/1-hello-alert/solution.md b/1-js/02-first-steps/01-hello-world/1-hello-alert/solution.md
@@ -0,0 +1,2 @@
+
+[html src="index.html"]
diff --git a/1-js/02-first-steps/01-hello-world/article.md b/1-js/02-first-steps/01-hello-world/article.md
@@ -54,8 +54,12 @@ Thuộc tính `type`: <code>&lt;script <u>type</u>=...&gt;</code>
 : Chuẩn HTML4 cũ yêu cầu mỗi script phải có một `type`. Thường là `type="text/javascript"`. Nhưng hiện nay nó không còn cần thiết nữa. Chuẩn HTML5 hiện đại vẫn sử dụng thuộc tính `type` nhưng với mục đích hoàn toàn khác. Bây giờ `type` được dùng cho các JavaScript module. Nhưng nó là một chủ đề nâng cao sẽ được nói đến trong một phần khác của loạt bài hướng dẫn này.
 =======
 The `type` attribute: <code>&lt;script <u>type</u>=...&gt;</code>
+<<<<<<< HEAD
 : The old HTML standard, HTML4, required a script to have a `type`. Usually it was `type="text/javascript"`. It's not required anymore. Also, the modern HTML standard totally changed the meaning of this attribute. Now, it can be used for JavaScript modules. But that's an advanced topic; we'll talk about modules in another part of the tutorial.
 >>>>>>> 34e9cdca3642882bd36c6733433a503a40c6da74
+=======
+: The old HTML standard, HTML4, required a script to have a `type`. Usually it was `type="text/javascript"`. It's not required anymore. Also, the modern HTML standard totally changed the meaning of this attribute. Now, it can be used for JavaScript modules. But that's an advanced topic, we'll talk about modules in another part of the tutorial.
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 
 Thuộc tính `language`: <code>&lt;script <u>language</u>=...&gt;</code>
 : Thuộc tính này cho biết script được viết bằng ngôn ngữ nào. Ngày nay JavaScript trở thành ngôn ngữ script mặc định, thuộc tính này không còn cần thiết nữa.
@@ -69,7 +73,11 @@ Các chú thích trước và sau script.
     //--></script>
     ```
 
+<<<<<<< HEAD
     Mẹo này không được sử dụng trong JavaScript hiện đại. Mục đích của chú thích là ẩn đi mã JavaScript trong các trình duyệt cũ không hỗ trợ thẻ `<script>`. Các trình duyệt phát hành trong 15 năm gần đây không gặp phải vấn đề này, kiểu đặt chú thích như thế này chỉ gặp trong nhưng đoạn mã rất cũ.
+=======
+    This trick isn't used in modern JavaScript. These comments hide JavaScript code from old browsers that didn't know how to process the `<script>` tag. Since browsers released in the last 15 years don't have this issue, this kind of comment can help you identify really old code.
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 
 
 ## Các script ngoài
@@ -93,7 +101,7 @@ Here, `/path/to/script.js` is an absolute path to the script from the site root.
 Một địa chỉ URL cũng được cho phép, ví dụ:
 
 ```html
-<script src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/3.2.0/lodash.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/4.17.11/lodash.js"></script>
 ```
 
 Để thêm nhiều script, sử dụng nhiều thẻ:

diff --git a/1-js/02-first-steps/02-structure/article.md b/1-js/02-first-steps/02-structure/article.md
@@ -94,7 +94,11 @@ Cách thấy này hiển nhiên sai vì thực ra đó là hai câu lệnh, đó
 
 Chúng tôi khuyên bạn nên đặt dấu chấm phảy giữa các câu lệnh ngay cả khi mỗi lệnh viết trên một dòng. Quy tắc này được cộng đồng áp dụng rộng rãi. Cùng nhắc lại một lần nữa -- *có thể* bỏ qua dấu chấm phảy trong hầu hết trường hợp. Nhưng để an toàn -- đặc biệt cho những người mới -- hãy luôn sử dụng chúng.
 
+<<<<<<< HEAD
 ## Các chú thích
+=======
+## Comments [#code-comments]
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 
 Theo thời gian, chương trình ngày càng phức tạp. Trong chương trình ta cần bổ sung thêm các "chú thích" để diễn giải hoạt động của mã trong chương trình.
 
@@ -135,8 +139,13 @@ alert('Chào');
 alert('thế giới!');
 ```
 
+<<<<<<< HEAD
 ```smart header="Dùng phím tắt!"
 Trong hầu hết các trình soạn thảo mã, có thể chú thích hóa một dòng mã bằng tổ hợp phím `key:Ctrl+/`, nhiều dòng mã bằng tổ hợp phím `key:Ctrl+Shift+/`. Trên máy Mac, dùng `key:Cmd` thay cho `key:Ctrl`.
+=======
+```smart header="Use hotkeys!"
+In most editors, a line of code can be commented out by pressing the `key:Ctrl+/` hotkey for a single-line comment and something like `key:Ctrl+Shift+/` -- for multiline comments (select a piece of code and press the hotkey). For Mac, try `key:Cmd` instead of `key:Ctrl` and `key:Option` instead of `key:Shift`.
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 ```
 
 ````warn header="Không được phép đặt một chú thích trong một chú thích khác (nested comment)!"

diff --git a/1-js/02-first-steps/03-strict-mode/article.md b/1-js/02-first-steps/03-strict-mode/article.md
@@ -23,6 +23,7 @@ Ví dụ:
 ...
 ```
 
+<<<<<<< HEAD
 <<<<<<< HEAD
 <<<<<<< HEAD
 Chúng ta sẽ học về các hàm (là cách nhóm các lệnh) ở một bài học gần đây.
@@ -35,6 +36,9 @@ We will learn functions (a way to group commands) soon. Looking ahead, let's not
 We will learn functions (a way to group commands) soon. Looking ahead, let's note that `"use strict"` can be put at the beginning of the function body instead of the whole script. Doing that enables strict mode in that function only. But usually, people use it for the whole script.
 >>>>>>> 5cb9760abb8499bf1e99042d866c3c1db8cd61ca
 
+=======
+Quite soon we're going to learn functions (a way to group commands), so let's note in advance that `"use strict"` can be put at the beginning of a function. Doing that enables strict mode in that function only. But usually people use it for the whole script.
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 
 ````warn header="Phải chắc chắn rằng đặt \"use strict\" ở đầu"
 Bạn phải chắc chắn rằng đặt `"use strict"` ở đầu script, nếu không chế độ "strict" không được bật.
@@ -56,16 +60,30 @@ Chỉ các chú thích được phép xuất hiện trước `"use strict"`.
 ```warn header="Không có cách hủy `use strict`"
 Không có chỉ dẫn nào kiểu như `"no use strict"` để tắt chế độ strict sau khi đã bật.
 
+<<<<<<< HEAD
 Một khi đã vào chế độ strict, không còn đường quay lại.
+=======
+Once we enter strict mode, there's no going back.
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 ```
 
 ## Console của trình duyệt
 
+<<<<<<< HEAD
 Cho tương lai khi bạn sử dụng console của trình duyệt để kiểm tra các tính năng mới của JavaScript, hãy chú ý rằng mặc định `use strict` không được sử dụng.
+=======
+When you use a [developer console](info:devtools) to run code, please note that it doesn't `use strict` by default.
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 
 Thỉnh thoảng, khi `use strict` tạo ra sự khác biệt, bạn sẽ nhận được các kết quả không đúng.
 
+<<<<<<< HEAD
 Bạn có thể thử bấm tổ hợp phím `key:Shift+Enter` để nhập mã trên nhiều dòng và đặt `use strict` ở đầu, như sau:
+=======
+So, how to actually `use strict` in the console?
+
+First, you can try to press `key:Shift+Enter` to input multiple lines, and put `use strict` on top, like this:
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 
 ```js
 'use strict'; <Shift+Enter để xuống dòng>
@@ -75,12 +93,17 @@ Bạn có thể thử bấm tổ hợp phím `key:Shift+Enter` để nhập mã
 
 Nó làm việc trong hầu hết trình duyệt, như Firefox và Chrome.
 
+<<<<<<< HEAD
 Nếu không làm việc, cách tin cậy nhất để chắc chắn `use strict` chạy được là viết như sau:
+=======
+If it doesn't, e.g. in an old browser, there's an ugly, but reliable way to ensure `use strict`. Put it inside this kind of wrapper:
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9
 
 ```js
 (function() {
   'use strict';
 
+<<<<<<< HEAD
   // ...mã của bạn...
 })()
 ```
@@ -97,3 +120,24 @@ Hiện tại, chúng ta chỉ cân biết những điểm tổng quát như sau:
 2. Chế độ strict được bật bằng cách đặt `"use strict"` ở đầu script hoặc hàm. Vài tính năng của ngôn ngữ như "class" và "module" tự động bật chế độ strict khi được sử dụng.
 3. Chế độ strict được hỗ trợ bởi hầu hết trình duyệt.
 4. Chúng tôi khuyến khích bạn luôn bắt đầu script với `"use strict"`. Tất cả các ví dụ trong loạt bài hướng dẫn này để mặc định sử dụng chế độ strict (trừ vài trường hợp hiếm).
+=======
+  // ...your code here...
+})()
+```
+
+## Should we "use strict"?
+
+The question may sound obvious, but it's not so.
+
+One could recommend to start scripts with `"use strict"`... But you know what's cool?
+
+Modern JavaScript supports "classes" and "modules" - advanced language structures (we'll surely get to them), that enable `use strict` automatically. So we don't need to add the `"use strict"` directive, if we use them.
+
+**So, for now `"use strict";` is a welcome guest at the top of your scripts. Later, when your code is all in classes and modules, you may omit it.**
+
+As of now, we've got to know about `use strict` in general.
+
+In the next chapters, as we learn language features, we'll see the differences between the strict and old modes. Luckily, there aren't many and they actually make our lives better.
+
+All examples in this tutorial assume strict mode unless (very rarely) specified otherwise.
+>>>>>>> 445bda39806050acd96f87166a7c97533a0c67e9