Merge pull request #186 from javascript-tutorial/sync-6ab384f2

Sync with upstream @ 6ab384f

Author: yoga1234

1-js/01-getting-started/2-manuals-specifications/article.md

@@ -13,7 +13,11 @@ Versi spesifikasi baru dirilis tiap tahun. Di antara rilis ini, draft spesifikas
 
 Untuk membaca tentang fitur terkini, termasuk yang "hampir menjadi standar" (disebut "stage 3"), lihat proposalnya di <https://github.com/tc39/proposals>.
 
+<<<<<<< HEAD
 Juga, jika kamu dalam pengembangan untuk peramban, maka ada spek lain yang dibahas di [bagian kedua](info:browser-environment) di tutorial ini.
+=======
+Also, if you're developing for the browser, then there are other specifications covered in the [second part](info:browser-environment) of the tutorial.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 ## Manual
 

1-js/01-getting-started/4-devtools/article.md

@@ -8,7 +8,11 @@ Supaya bisa melihat error dan memperoleh informasi berfaedah lainnya dari script
 
 Kebanyakan pengembang memakai Chrome atau Firefox untuk pengembangan karena tools pengembangan yang mereka punya paling mantap. Peramban lain punya juga koq, ada with special features, but are usually playing "catch-up" to Chrome or Firefox. So most developers have a "favorite" browser and switch to others if a problem is browser-specific.
 
+<<<<<<< HEAD
 Tools pengembang mengandung faedah; mereka punya banyak fitur. Untuk memulainya, kita akan belajar cara membuka mereka, mencari error, dan menjalankan perintah JavaScript.
+=======
+Developer tools are potent; they have many features. To start, we'll learn how to open them, look at errors, and run JavaScript commands.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 ## Google Chrome
 

1-js/02-first-steps/08-operators/3-primitive-conversions-questions/solution.md

@@ -9,7 +9,6 @@ true + false = 1
 "$" + 4 + 5 = "$45"
 "4" - 2 = 2
 "4px" - 2 = NaN
-7 / 0 = Infinity
 "  -9  " + 5 = "  -9  5" // (3)
 "  -9  " - 5 = -14 // (4)
 null + 1 = 1 // (5)

1-js/02-first-steps/08-operators/3-primitive-conversions-questions/task.md

@@ -16,7 +16,6 @@ true + false
 "$" + 4 + 5
 "4" - 2
 "4px" - 2
-7 / 0
 "  -9  " + 5
 "  -9  " - 5
 null + 1

1-js/02-first-steps/08-operators/article.md

@@ -56,18 +56,35 @@ alert( 8 % 3 ); // 2, sisa dari pembagian antara 8 dibagi 3
 
 ### Eksponensial **
 
+<<<<<<< HEAD
 Operator eksponensial `a ** b` mengkalikan `a` dengan nilai itu sendiri sebanyak `b` kali.
+=======
+The exponentiation operator `a ** b` raises `a` to the power of `b`.
+
+In school maths, we write that as a<sup>b</sup>.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 Contoh:
 
 ```js run
+<<<<<<< HEAD
 alert( 2 ** 2 ); // 4  (2 dikalikan dengan nilai itu sendiri sebanyak 2 kali)
 alert( 2 ** 3 ); // 8  (2 * 2 * 2, 3 kali)
 alert( 2 ** 4 ); // 16 (2 * 2 * 2 * 2, 4 kali)
 ```
 
 Secara matematis, eksponensial juga bisa digunakan untuk nomor yang bukan integer.
 Contoh, akar kuadrat adalah eksponen dari `1/2`:
+=======
+alert( 2 ** 2 ); // 2² = 4  
+alert( 2 ** 3 ); // 2³ = 8 
+alert( 2 ** 4 ); // 2⁴ = 16
+```
+
+Just like in maths, the exponentiation operator is defined for non-integer numbers as well. 
+
+For example, a square root is an exponentiation by ½:
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 ```js run
 alert( 4 ** (1/2) ); // 2 (pangkat 1/2 sama dengan akar kuadrat)

1-js/02-first-steps/10-ifelse/2-check-standard/task.md

@@ -6,7 +6,11 @@ Nilai penting: 2
 
 Dengan menggunakan konstruksi `if..else`, tulis kode yang menanyakan: 'Apa nama "official" JavaScript?'
 
+<<<<<<< HEAD
 Jika pengunjung memasukkan "ECMAScript", maka tunjukkan output "Benar!", Jika tidak - tunjukkan output: "Tidak tahu? ECMAScript!"
+=======
+If the visitor enters "ECMAScript", then output "Right!", otherwise -- output: "You don't know? ECMAScript!"
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 ![](ifelse_task2.svg)
 

1-js/02-first-steps/11-logical-operators/article.md

@@ -1,6 +1,10 @@
 # Operator logika
 
+<<<<<<< HEAD
 Ada tiga operator logika di JavaScript: `||` (OR), `&&` (AND), `!` (NOT).
+=======
+There are four logical operators in JavaScript: `||` (OR), `&&` (AND), `!` (NOT), `??` (Nullish Coalescing). Here we cover the first three, the `??` operator is in the next article.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 Meski mereka dipanggil "logika", mereka bisa diaplikasikan ke nilai tipe apapun, bukan cuma boolean. Hasil mereka bisa juga tipe apapun.
 
@@ -64,7 +68,11 @@ if (hour < 10 || hour > 18 || isWeekend) {
 }
 ```
 
+<<<<<<< HEAD
 ## OR "||" mencari nilai truthy pertama
+=======
+## OR "||" finds the first truthy value [#or-finds-the-first-truthy-value]
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 Logika di atas memang klasik. Sekarang, mari bawa fitur "extra" JavaScript.
 

1-js/02-first-steps/12-nullish-coalescing-operator/article.md

@@ -2,6 +2,7 @@
 
 [recent browser="new"]
 
+<<<<<<< HEAD
 Disini, didalam artikel ini, kita bisa mengatakan sebuah ekspresi telah "didefinisikan" ketika nilainya bukanlah `null` ataupun `undefined`.
 
 Operator penggabungan nullish ditulis sebagai dua tanda tanya `??`.
@@ -14,6 +15,16 @@ Hasil dari `a ?? b` adalah:
 <<<<<<< HEAD
 Dengan kata lain, `??` mengembalikan argumen pertama jika argumen tersebut telah didefinisikan. Sebaliknya, mengembalikan argumen kedua jika argumen pertama belum didefinisikan.
 =======
+=======
+The nullish coalescing operator is written as two question marks `??`.
+
+As it treats `null` and `undefined` similarly, we'll use a special term here, in this article. We'll say that an expression is "defined" when it's neither `null` nor `undefined`.
+
+The result of `a ?? b` is:
+- if `a` is defined, then `a`,
+- if `a` isn't defined, then `b`.
+
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 In other words, `??` returns the first argument if it's not `null/undefined`. Otherwise, the second one.
 >>>>>>> d6e88647b42992f204f57401160ebae92b358c0d
 
@@ -25,22 +36,34 @@ Kita bisa menulis ulang `result = a ?? b` menggunakan operator yang sudah kita k
 result = (a !== null && a !== undefined) ? a : b;
 ```
 
+<<<<<<< HEAD
 Penggunaan umum untuk `??` adalah untuk menyediakan nilai _default_ untuk variabel yang mungkin _undefined_.
 
 Sebagai contoh, kita disini menampilkan `Anonymous` jika `user` belum didefinisikan:
+=======
+Now it should be absolutely clear what `??` does. Let's see where it helps.
+
+The common use case for `??` is to provide a default value for a potentially undefined variable.
+
+For example, here we show `user` if defined, otherwise `Anonymous`:
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 ```js run
 let user;
 
-alert(user ?? "Anonymous"); // Anonymous
+alert(user ?? "Anonymous"); // Anonymous (user not defined)
 ```
 
+<<<<<<< HEAD
 tentu saja, jika `user` memiliki nilai apapun kecuali `null/undefined`, maka kita akan bisa melihat nilainya:
+=======
+Here's the example with `user` assigned to a name:
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 ```js run
 let user = "John";
 
-alert(user ?? "Anonymous"); // John
+alert(user ?? "Anonymous"); // John (user defined)
 ```
 
 <<<<<<< HEAD
@@ -49,9 +72,15 @@ Kita juga bisa menggunakan rentetan `??` untuk mendapatkan nilai yang telah dide
 We can also use a sequence of `??` to select the first value from a list that isn't `null/undefined`.
 >>>>>>> d6e88647b42992f204f57401160ebae92b358c0d
 
+<<<<<<< HEAD
 Katakan kita memiliki sebuah data _user_ didalam sebuah variabel `firstName`, `lastName`, atau `nickName`. Semuanya mungkin saya memiliki nilai _undefined_, jika _user_ nya tidak memasukan nilainya.
 
 Kita ingin menampilkan nama _user_ menggunakan salah satu dari variabel ini, atau menampilkan "Anonymous" jika semua nilainya adalah _undefined_.
+=======
+Let's say we have a user's data in variables `firstName`, `lastName` or `nickName`. All of them may be not defined, if the user decided not to enter a value.
+
+We'd like to display the user name using one of these variables, or show "Anonymous" if all of them aren't defined.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 Kita coba gunakan operator `??` untuk hal itu:
 
@@ -83,7 +112,11 @@ alert(firstName || lastName || nickName || "Anonymous"); // Supercoder
 */!*
 ```
 
+<<<<<<< HEAD
 Operator OR `||` sudah ada sejak awal mula dari Javascript, jadi sudah sejak lama pengembang menggunakan operator _or_ untuk kebutuhan seperti contoh diatas.
+=======
+Historically, the OR `||` operator was there first. It exists since the beginning of JavaScript, so developers were using it for such purposes for a long time.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 <<<<<<< HEAD
 Disisi yang lain, operator penggabung nullish `??` baru saja ditambahkan, dan alasan penambahannya adalah karena para pengembang kurang senang dengan `||`.
@@ -113,6 +146,7 @@ alert(height || 100); // 100
 alert(height ?? 100); // 0
 ```
 
+<<<<<<< HEAD
 <<<<<<< HEAD
 Disini, kita memiliki _height_ nol.
 
@@ -130,10 +164,24 @@ Jika kita asumsikan bahwa _height_ nol adalah nilai yang valid, maka nilainya ti
 
 If the zero height is a valid value, that shouldn't be replaced with the default, then `??` does just the right thing.
 >>>>>>> d6e88647b42992f204f57401160ebae92b358c0d
+=======
+- The `height || 100` checks `height` for being a falsy value, and it's `0`, falsy indeed.
+    - so the result of `||` is the second argument, `100`.
+- The `height ?? 100` checks `height` for being `null/undefined`, and it's not,
+    - so the result is `height` "as is", that is `0`.
+
+In practice, the zero height is often a valid value, that shouldn't be replaced with the default. So `??` does just the right thing.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 ## Precedence/Hak lebih tinggi
 
+<<<<<<< HEAD
 _Precedence_ dari operator `??` agak rendah: `5` didalam [tabel MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence#Table). Jadi `??` akan dievaluasi sebelum `=` dan `?`, tapi setelah di kebanyakan dari operasi lainnya, seperti `+`, `*`.
+=======
+The precedence of the `??` operator is about the same as `||`, just a bit lower. It equals `5` in the [MDN table](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence#Table), while `||` is `6`.
+
+That means that, just like `||`, the nullish coalescing operator `??` is evaluated before `=` and `?`, but after most other operations, such as `+`, `*`.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 Jadi jika kita ingin memilih sebuah nilai dengan `??` didalam sebuah ekspresi dengan operator lain, cobalah untuk menggunakan kurung:
 
@@ -167,7 +215,11 @@ Kode dibawah akan menampilkan sintaks error:
 let x = 1 && 2 ?? 3; // Syntax error
 ```
 
+<<<<<<< HEAD
 Tentu saja batasan seperti itu bisa diperdebatkan, akan tetapi hal itu telah ditambahkan kedalam spesifikasi bahasanya dengan tujuan untuk menghindari kesalahan memprogram, sebagaimana orang-orang mulai berpindah dari `??` ke `||`.
+=======
+The limitation is surely debatable, it was added to the language specification with the purpose to avoid programming mistakes, when people start to switch from `||` to `??`.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 Gunakan kurung yang jelas jika ingin menggunakannya:
 

1-js/02-first-steps/13-while-for/article.md

@@ -318,7 +318,11 @@ alert('Done!');
 
 Kita butuh cara untuk menghentikan proses jika pengguna membatalkan input.
 
+<<<<<<< HEAD
 `break` biasa setelah `input` hanya akan menghentikan perulangan dalam. Itu tidak cukup--label, datang untuk menyelamatkan!
+=======
+The ordinary `break` after `input` would only break the inner loop. That's not sufficient -- labels, come to the rescue!
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 Label adalah sebuah pengidentifikasi dengan sebuah titik dua sebelum perulangan:
 ```js
@@ -363,12 +367,31 @@ Label tidak mengizinkan kita untuk lompat ke sembarang tempat dalam kode.
 
 Misalnya, mustahil melakukan ini:
 ```js
+<<<<<<< HEAD
 break label;  // tidak lompak ke label di bawah
+=======
+break label; // jump to the label below (doesn't work)
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 label: for (...)
 ```
 
+<<<<<<< HEAD
 Sebuah panggilan untuk `break/continue` hanya mungkin dari dalam sebuah perulangan dan label harus berada diatas perintah.
+=======
+A `break` directive must be inside a code block. Technically, any labelled code block will do, e.g.:
+```js
+label: {
+  // ...
+  break label; // works
+  // ...
+}
+```
+
+...Although, 99.9% of the time `break` used is inside loops, as we've seen in the examples above.
+
+A `continue` is only possible from inside a loop.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 ````
 
 ## Ringkasan

1-js/02-first-steps/15-function-basics/2-rewrite-function-question-or/solution.md

@@ -15,4 +15,8 @@ function checkAge(age) {
 }
 ```
 
+<<<<<<< HEAD
 Catatan bahwa tanda kurung sekitar `age > 18` tidak dibutuhkan disini. Mereka ada hanya untuk lebih enak dibaca.
+=======
+Note that the parentheses around `age > 18` are not required here. They exist for better readability.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96