Merge pull request #315 from guidofamula/open-dev1

Adding/correct Bahasa and made minor improvements

Author: yoga1234

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

@@ -1,7 +1,6 @@
-
 # Manual dan spesifikasi
 
-Buku ini adalah *tutorial*. Tujuannya membantu kamu memahami bahasa ini pelan-pelan. Tapi sekali kamu akrab dengan dasarnya, kamu butuh sumber lain.
+Buku ini adalah _tutorial_. Tujuannya membantu kamu memahami bahasa ini (Javascript) pelan-pelan. Tapi sekali kamu akrab atau familiar dengan dasarnya, kamu juga membutuhkan dari sumber-sumber lain.
 
 ## Spesifikasi
 
@@ -17,14 +16,13 @@ Juga, jika kamu dalam pengembangan untuk peramban, maka ada spek lain yang dibah
 
 ## Manual
 
-- **Referensi JavaScript MDN (Mozilla)** ialah manual dengan informasi dan contoh lain. Di sana bagus untuk mendapat informasi mendalam tentang metode, fungsi bahasa, dll.
+-   **Referensi JavaScript MDN (Mozilla)** ialah manual dengan informasi dan contoh lain. Di sana bagus untuk mendapat informasi mendalam tentang metode, fungsi bahasa, dll.
 
     Kamu bisa cari di <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
 
     Meski, sering lebih bagus menggunakan pencarian internet. Pakai "MDN [term]" di query, misal <https://google.com/search?q=MDN+parseInt> untuk mencari fungsi `parseInt`.
 
-
-- **MSDN** – Manual Microsoft dengan banyak informasi, termasuk JavaScript (sering dirujuk sebagai JScript). Jika kamu butuh sesuatu yang spesifik ke Internet Explorer, lebih baik pergi ke: <http://msdn.microsoft.com/>.
+-   **MSDN** – Manual Microsoft dengan banyak informasi, termasuk JavaScript (sering dirujuk sebagai JScript). Jika kamu butuh sesuatu yang spesifik ke Internet Explorer, lebih baik pergi ke: <http://msdn.microsoft.com/>.
 
     Juga, kamu bisa menggunakan pencarian internet dengan frasa seperti "RegExp MSDN" atau "RegExp MSDN jscript".
 
@@ -34,8 +32,8 @@ JavaScript merupakan bahasa berkembang, fitur baru ditambah secara reguler.
 
 Untuk melihat dukungan mereka pada engine berbasis peramban dan lainnya, lihat:
 
-- <http://caniuse.com> - tabel dukungan per-fitur, misal untuk melihat engine mana yang mendukung fungsi kryptografi modern: <http://caniuse.com/#feat=cryptography>.
-- <https://kangax.github.io/compat-table> - tabel dengan fitur dan engine bahasa yang mendukung atau yang tidak mendukung.
+-   <http://caniuse.com> - tabel dukungan per-fitur, misal untuk melihat engine mana yang mendukung fungsi kryptografi modern: <http://caniuse.com/#feat=cryptography>.
+-   <https://kangax.github.io/compat-table> - tabel dengan fitur dan engine bahasa yang mendukung atau yang tidak mendukung.
 
 Semua sumber ini berguna di pengembangan nyata, karena mereka berisi informasi berharga tentang detil bahasa, dukungan mereka dll.
 

Diff for: 1-js/03-code-quality/05-testing-mocha/article.md

@@ -36,28 +36,23 @@ Tugas itu cuma contoh: ada operator `**` di JavaScript yang bisa melakukan itu,
 
 Sebelum membuat kode `pow`, kita bisa bayangkan apa yang harus dilakukan fungsi itu dan menjelaskannya.
 
-Deskripsi begitu disebut *spesifikasi* atau, singkatnya, spek, dan berisi deskripsi use case bersama dengan tes untuk mereka, seperti ini:
+Deskripsi begitu disebut _spesifikasi_ atau, singkatnya, spek, dan berisi deskripsi use case bersama dengan tes untuk mereka, seperti ini:
 
 ```js
-describe("pow", function() {
-
-  it("raises to n-th power", function() {
+describe("pow", function () {
+  it("raises to n-th power", function () {
     assert.equal(pow(2, 3), 8);
   });
-
 });
 ```
 
 Spek punya tiga blok bangunan utama yang bisa kamu lihat di bawah:
 
-`describe("title", function() { ... })`
-: Fungsionalitas apa yang kita jelaskan. Di kasus ini kita akan menjelaskan fungsi `pow`. Dipakai untuk mengelompokkan "pekerja" -- blok `it`.
+`describe("title", function() { ... })` : Fungsionalitas apa yang kita jelaskan. Di kasus ini kita akan menjelaskan fungsi `pow`. Dipakai untuk mengelompokkan "pekerja" -- blok `it`.
 
-`it("use case description", function() { ... })`
-: Di judul `it` kita *dalam bahasa manusia* menjelaskan use case tertentu, dan argumen kedua ialah fungsi yang mengetes itu.
+`it("use case description", function() { ... })` : Di judul `it` kita _dalam bahasa manusia_ menjelaskan use case tertentu, dan argumen kedua ialah fungsi yang mengetes itu.
 
-`assert.equal(value1, value2)`
-: Kode di dalam blok `it`, jika implementasinya benar, harus berjalan tanpa galat.
+`assert.equal(value1, value2)` : Kode di dalam blok `it`, jika implementasinya benar, harus berjalan tanpa galat.
 
     Fungsi `assert.*` dipakai untuk mengecek apakah `pow` bekerja sesuai harapan. Tepat di sini kita memakai salah satunya -- `assert.equal`, ia membandingkan argumen dan menghasilkan galat jika mereka tak sama. Di sini ia mengecek apakah hasil `pow(2, 3)` sama dengan `8`. Ada tipe perbandingan dan pengecekan lain, yang akan kita tambah nanti.
 
@@ -75,7 +70,7 @@ Alur pengembangan biasanya seperti ini:
 6. Pergi ke 3, perbaharui implementasinya hingga tes tak memberikan galat.
 7. Ulangi langkah 3-6 hingga fungsionalitasnya siap.
 
-Jadi, pengembangannya *iteratif*. Kita tulis spek, implementasikan, memastikan tes lulus, lalu menulis tes lainnya, memastikan mereka bekerja dll. Akhirnya kita punya implementasi yang bekerja dan tes untuk itu.
+Jadi, pengembangannya _iteratif_. Kita tulis spek, implementasikan, memastikan tes lulus, lalu menulis tes lainnya, memastikan mereka bekerja dll. Akhirnya kita punya implementasi yang bekerja dan tes untuk itu.
 
 Ayo lihat alur pengembangan ini di kasus praktik kita.
 
@@ -86,19 +81,20 @@ Langkap pertama sudah lengkap: kita punya spek inisial untuk `pow`. Sekarang, se
 Di sini di tutorial ini kita akan memakai librari JavaScript untuk tes:
 
 - [Mocha](http://mochajs.org/) -- inti framework: menyediakan fungsi testing umum `describe` dan `it` dan fungsi utama yang menjalankan test.
-- [Chai](http://chaijs.com) -- library dengan banyak penambahan. Ini membuatmu bisa untuk menggunakan banyak penambahan yang berbeda, untuk sekarang kita hanya membutuhkan `assert.equal`.
-- [Sinon](http://sinonjs.org/) -- sebuah library untuk memata-matai fungsi, meniru fungsi bawaan dan lainnya, kita akan butuh ini nanti.
+- [Chai](http://chaijs.com) -- librari dengan banyak penambahan. Ini membuatmu bisa untuk menggunakan banyak penambahan yang berbeda, untuk sekarang kita hanya membutuhkan `assert.equal`.
+- [Sinon](http://sinonjs.org/) -- sebuah librari untuk memata-matai fungsi, meniru fungsi bawaan dan lainnya, kita akan butuh ini nanti.
 
 Librari ini cocok baik untuk pengetesan in-browser dan server-side. Di sini kita akan mempertimbangkan varian peramban.
 
 Laman HTML lengkap dengan framework ini dan spek `pow`:
 
 ```html src="index.html"
+
 ```
 
 Laman ini bisa dibagi jadi lima bagian:
 
-1. `<head>` -- menambah libraru dan gaya pihak-ketiga untuk tes.
+1. `<head>` -- menambah librari dan gaya pihak-ketiga untuk tes.
 2. `<script>` dengan fungsi untuk dites, di kasus kita -- degngan kode untuk `pow`.
 3. Tes -- di kasus kita script external `test.js` yang punya `describe("pow", ...)` dari atas.
 4. Elemen HTML `<div id="mocha">` akan dipakai untuk mengoutputkan hasil.
@@ -138,33 +134,32 @@ Kita bisa pilih salah satu cara mengorganisasikan tes di sini:
 
 1. Varian pertama -- tambah satu lagi `assert` ke dalam `it` yang sama:
 
-    ```js
-    describe("pow", function() {
+   ```js
+   describe("pow", function() {
 
-      it("raises to n-th power", function() {
-        assert.equal(pow(2, 3), 8);
-    *!*
-        assert.equal(pow(3, 4), 81);
-    */!*
-      });
+     it("raises to n-th power", function() {
+       assert.equal(pow(2, 3), 8);
+   *!*
+       assert.equal(pow(3, 4), 81);
+   */!*
+     });
+
+   });
+   ```
 
-    });
-    ```
 2. Kedua -- buat dua tes:
 
-    ```js
-    describe("pow", function() {
+   ```js
+   describe("pow", function () {
+     it("2 raised to power 3 is 8", function () {
+       assert.equal(pow(2, 3), 8);
+     });
 
-      it("2 raised to power 3 is 8", function() {
-        assert.equal(pow(2, 3), 8);
-      });
-
-      it("3 raised to power 4 is 81", function() {
-        assert.equal(pow(3, 4), 81);
-      });
-
-    });
-    ```
+     it("3 raised to power 4 is 81", function () {
+       assert.equal(pow(3, 4), 81);
+     });
+   });
+   ```
 
 Perbedaan prinsipal ialah saat `assert` memicu galat, blok `it` segera berhenti. Jadi, di varian pertama jika `assert` pertama gagal, maka kita takkan pernah melihat hasil `assert` kedua.
 
@@ -203,19 +198,17 @@ function pow(x, n) {
 Untuk yakin bahwa fungsi bekerja dengan baik, ayo kita tes dia dengan lebih banyak nilai. Daripada menulis blok `it` secara manual, kita bisa menggenerate mereka di `for`:
 
 ```js
-describe("pow", function() {
-
+describe("pow", function () {
   function makeTest(x) {
     let expected = x * x * x;
-    it(`${x} in the power 3 is ${expected}`, function() {
+    it(`${x} in the power 3 is ${expected}`, function () {
       assert.equal(pow(x, 3), expected);
     });
   }
 
   for (let x = 1; x <= 5; x++) {
     makeTest(x);
   }
-
 });
 ```
 
@@ -261,23 +254,20 @@ describe("pow", function() {
 
 Di masa depan kita bisa menambah lebih banyak `it` dan `describe` di level tertinggi dengan fungsi pembantu mereka sendiri, mereka takkan melihat `makeTest`.
 
-````smart header="`before/after` dan `beforeEach/afterEach`"
-Kita bisa mengeset fungsi `before/after` yang berjalan sebelum/setelah menjalankan tes, dan juga fungsi `beforeEach/afterEach` yang berjalan sebelum/setelah *setiap* `it`.
+````smart header="`before/after`dan`beforeEach/afterEach`" Kita bisa mengeset fungsi `before/after`yang berjalan sebelum/setelah menjalankan tes, dan juga fungsi`beforeEach/afterEach`yang berjalan sebelum/setelah *setiap*`it`.
 
 Misalnya:
 
 ```js no-beautify
-describe("test", function() {
-
+describe("test", function () {
   before(() => alert("Testing started – before all tests"));
   after(() => alert("Testing finished – after all tests"));
 
   beforeEach(() => alert("Before a test – enter a test"));
   afterEach(() => alert("After a test – exit a test"));
 
-  it('test 1', () => alert(1));
-  it('test 2', () => alert(2));
-
+  it("test 1", () => alert(1));
+  it("test 2", () => alert(2));
 });
 ```
 
@@ -297,6 +287,7 @@ Tes selesai – setelah semua tes (after)
 [edit src="beforeafter" title="Buka contoh di sandbox."]
 
 Biasanya, `beforeEach/afterEach` dan `before/after` dipakai untuk melakukan inisialisasi, mengnolkan counter atau melakukan sesuatu di antara tes (atau grup tes).
+
 ````
 
 ## Mengextend spek
@@ -322,7 +313,7 @@ describe("pow", function() {
 
   it("untuk n non-integer hasilnya NaN", function() {
 *!*
-    assert.isNaN(pow(2, 1.5));    
+    assert.isNaN(pow(2, 1.5));
 */!*
   });
 
@@ -407,3 +398,4 @@ Di kehidupan riil kadang tak mudah. Kadang sulit menulis spek sebelum kode aktua
 Nanti di tutorial ini kamu akan menemui banyak tugas dengan tes yang matang. Jadi kamu akan melihat banyak contoh praktik.
 
 Menulis tes membutuhkan pengetahuan JavaScript yang baik. Tapi kita baru saja mulai belajar. Jadi, supaya settle semuanya, dari sekarang kamu belum wajib menulis tes, tapi kamu harus sudah bisa membaca mereka meski mereka agak rumit dari yang ada di bab ini.
+````

Diff for: 1-js/03-code-quality/05-testing-mocha/beforeafter.view/index.html

@@ -1,34 +1,34 @@
 <!DOCTYPE html>
 <html>
-<head>
-  <!-- add mocha css, to show results -->
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/mocha/3.2.0/mocha.css">
-  <!-- add mocha framework code -->
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/mocha/3.2.0/mocha.js"></script>
-  <script>
-    // enable bdd-style testing
-    mocha.setup('bdd');
-  </script>
-  <!-- add chai -->
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/chai/3.5.0/chai.js"></script>
-  <script>
-    // chai has a lot of stuff, let's make assert global
-    let assert = chai.assert;
-  </script>
-</head>
+  <head>
+    <!-- Tambahkan mocha css untuk menampilkan hasil. -->
+    <link
+      rel="stylesheet"
+      href="https://cdnjs.cloudflare.com/ajax/libs/mocha/3.2.0/mocha.css"
+    />
+    <!-- Tambahkan kode kerangka kerja/framework mocha -->
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/mocha/3.2.0/mocha.js"></script>
+    <script>
+      // Mengaktifkan pengujian dengan bdd-style
+      mocha.setup("bdd");
+    </script>
+    <!-- Tambahkan chai script -->
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/chai/3.5.0/chai.js"></script>
+    <script>
+      // Chai memiliki banyak fitur, mari kita membuat assert menjadi global.
+      let assert = chai.assert;
+    </script>
+  </head>
 
-<body>
-
-  <!-- the script with tests (describe, it...) -->
-  <script src="test.js"></script>
-
-  <!-- the element with id="mocha" will contain test results -->
-  <div id="mocha"></div>
-
-  <!-- run tests! -->
-  <script>
-    mocha.run();
-  </script>
-</body>
+  <body>
+    <!-- Skrip dengan pengujian (describe, it...). -->
+    <script src="test.js"></script>
+    <!-- Elemen dengan id="mocha" akan berisi hasil uji coba/test. -->
+    <div id="mocha"></div>
 
+    <!-- Jalankan pengujian/tests -->
+    <script>
+      mocha.run();
+    </script>
+  </body>
 </html>