Merge pull request #341 from javascript-tutorial/sync-4541b7af

Sync with upstream @ 4541b7a

Author: HachemiH

1-js/01-getting-started/1-intro/article.md

@@ -63,7 +63,11 @@ Par exemple, JavaScript dans le navigateur est capable de :
 
 Les capacités de JavaScript dans le navigateur sont limitées pour la sécurité de l'utilisateur. L'objectif est d'empêcher une page Web malfaisante d'accéder à des informations privées ou de nuire aux données de l'utilisateur.
 
+<<<<<<< HEAD
 Les exemples de telles restrictions sont:
+=======
+JavaScript's abilities in the browser are limited for the sake of a user's safety. The aim is to prevent an evil webpage from accessing private information or harming the user's data.
+>>>>>>> 4541b7af7584014a676da731f6e8774da5e059f6
 
 - JavaScript sur une page Web ne peut pas lire/écrire des fichiers arbitrairement sur le disque dur, les copier ou exécuter des programmes. Il n'a pas d'accès direct aux fonctions du système d'exploitation.
 
@@ -88,9 +92,15 @@ De telles limites n'existent pas si JavaScript est utilisé en dehors du navigat
 Il y a au moins trois bonnes choses à propos de JavaScript:
 
 ```compare
+<<<<<<< HEAD
 + Intégration complète avec HTML / CSS.
 + Les choses simples sont faites simplement.
 + Pris en charge par tous les principaux navigateurs et activé par défaut.
+=======
++ Full integration with HTML/CSS.
++ Simple things are done simply.
++ Supported by all major browsers and enabled by default.
+>>>>>>> 4541b7af7584014a676da731f6e8774da5e059f6
 ```
 
 JavaScript est la seule technologie de navigateur qui combine ces trois éléments.
@@ -122,6 +132,12 @@ Il en existe évidemment bien plus, cela dit, même si nous utilisons un de ces
 
 ## Résumé
 
+<<<<<<< HEAD
 - JavaScript a été initialement créé en tant que langage de navigateur uniquement, mais il est désormais également utilisé dans de nombreux autres environnements.
 - En ce moment, JavaScript occupe une position unique en tant que langage de navigateur le plus largement adopté avec une intégration complète avec HTML/CSS.
 - De nombreux langages sont "transpilés" en JavaScript et fournissent certaines fonctionnalités. Il est recommandé d'y jeter un coup d'œil, au moins brièvement, après avoir maîtrisé JavaScript.
+=======
+- JavaScript was initially created as a browser-only language, but it is now used in many other environments as well.
+- Today, JavaScript has a unique position as the most widely-adopted browser language, fully integrated with HTML/CSS.
+- There are many languages that get "transpiled" to JavaScript and provide certain features. It is recommended to take a look at them, at least briefly, after mastering JavaScript.
+>>>>>>> 4541b7af7584014a676da731f6e8774da5e059f6

1-js/02-first-steps/01-hello-world/article.md

@@ -76,7 +76,11 @@ Le fichier de script est attaché à HTML avec l'attribut `src` :
 <script src="/chemin/vers/script.js"></script>
 ```
 
+<<<<<<< HEAD
 Ici, `/chemin/vers/script.js` est un chemin absolu du script depuis la racine du site. On peut également fournir un chemin relatif à partir de la page en cours. Par exemple `src="script.js"` signifierait un fichier `"script.js"` dans le dossier courrant.
+=======
+Here, `/path/to/script.js` is an absolute path to the script from the site root. One can also provide a relative path from the current page. For instance, `src="script.js"`, just like `src="./script.js"`, would mean a file `"script.js"` in the current folder.
+>>>>>>> 4541b7af7584014a676da731f6e8774da5e059f6
 
 Nous pouvons également donner une URL complète, par exemple :
 

1-js/05-data-types/03-string/article.md

@@ -79,6 +79,7 @@ Il existe d'autres caractères "spéciaux" moins courants.
 
 Voici la liste complète :
 
+<<<<<<< HEAD
 | Caractère                                          | Description                                                                                                                                                                                      |
 |----------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | `\n`                                               | Nouvelle ligne                                                                                                                                                                                   |
@@ -90,6 +91,19 @@ Voici la liste complète :
 | `\xXX`                                             | Caractère Unicode avec l'unicode hexadécimal donné `XX`, par exemple `'\x7A'` est le même que `'z'`.                                                                                             |
 | `\uXXXX`                                           | Un symbole Unicode avec le code hexadécimal `XXXX` en encodage UTF-16, par exemple `\u00A9` -- est un unicode pour le symbole de copyright `©`. Ce doit être exactement 4 chiffres hexadécimaux. |
 | `\u{X…XXXXXX}` (de 1 à 6 caractères hexadécimaux ) | Un symbole Unicode avec l'encodage UTF-32. Certains caractères rares sont encodés avec deux symboles Unicode, prenant 4 octets. De cette façon, nous pouvons insérer des codes longs.           |
+=======
+| Character | Description |
+|-----------|-------------|
+|`\n`|New line|
+|`\r`|In Windows text files a combination of two characters `\r\n` represents a new break, while on non-Windows OS it's just `\n`. That's for historical reasons, most Windows software also understands `\n`. |
+|`\'`, `\"`|Quotes|
+|`\\`|Backslash|
+|`\t`|Tab|
+|`\b`, `\f`, `\v`| Backspace, Form Feed, Vertical Tab -- kept for compatibility, not used nowadays. |
+|`\xXX`|Unicode character with the given hexadecimal Unicode `XX`, e.g. `'\x7A'` is the same as `'z'`.|
+|`\uXXXX`|A Unicode symbol with the hex code `XXXX` in UTF-16 encoding, for instance `\u00A9` -- is a Unicode for the copyright symbol `©`. It must be exactly 4 hex digits. |
+|`\u{X…XXXXXX}` (1 to 6 hex characters)|A Unicode symbol with the given UTF-32 encoding. Some rare characters are encoded with two Unicode symbols, taking 4 bytes. This way we can insert long codes. |
+>>>>>>> 4541b7af7584014a676da731f6e8774da5e059f6
 
 Exemples avec unicode :
 

1-js/06-advanced-functions/03-closure/9-sort-by-field/_js.view/test.js

@@ -23,7 +23,7 @@ describe("byField", function(){
       { name: "John", age: 20, surname: "Johnson"},
     ];
     let ageSortedAnswer = users.sort(byField("age"));
-    assert.deepEqual(ageSortedKey, ageSortedKey);
+    assert.deepEqual(ageSortedKey, ageSortedAnswer);
   });
 
   it("sorts users by surname", function(){

1-js/06-advanced-functions/10-bind/article.md

@@ -187,8 +187,8 @@ let user = {
 
 let say = user.say.bind(user);
 
-say("Hello"); // Hello, John ("Hello" argument is passed to say)
-say("Bye"); // Bye, John ("Bye" is passed to say)
+say("Hello"); // Hello, John! ("Hello" argument is passed to say)
+say("Bye"); // Bye, John! ("Bye" is passed to say)
 ```
 
 ````smart header="Convenience method: `bindAll`"

1-js/09-classes/06-instanceof/article.md

@@ -93,11 +93,19 @@ let rabbit = new Rabbit();
 alert(rabbit instanceof Animal); // true
 */!*
 
+<<<<<<< HEAD
 // rabbit.__proto__ === Rabbit.prototype
 *!*
 // rabbit.__proto__.__proto__ === Animal.prototype (match!)
 */!*
 ```
+=======
+    // rabbit.__proto__ === Animal.prototype (no match)
+    *!*
+    // rabbit.__proto__.__proto__ === Animal.prototype (match!)
+    */!*
+    ```
+>>>>>>> 4541b7af7584014a676da731f6e8774da5e059f6
 
 Voici l'illustration de ce que `rabbit instanceof Animal` compare avec `Animal.prototype`:
 

1-js/11-async/02-promise-basics/03-animate-circle-promise/solution.view/index.html

@@ -10,7 +10,7 @@
       text-align: center;
     }
     .circle {
-      transition-property: width, height, margin-left, margin-top;
+      transition-property: width, height;
       transition-duration: 2s;
       position: fixed;
       transform: translateX(-50%) translateY(-50%);

1-js/11-async/03-promise-chaining/article.md

@@ -34,11 +34,19 @@ new Promise(function(resolve, reject) {
 
 L'idée est que le résultat est transmis à travers la chaîne de gestionnaires `.then`.
 
+<<<<<<< HEAD
 Ici, le flux est :
 1. La promesse initiale est résolue en 1 seconde `(*)`,
 2. Ensuite, le gestionnaire `.then` est appelé `(**)`, qui à son tour crée une nouvelle promesse (résolue avec la valeur `2`).
 3. Le `then` suivant `(***)` obtient le résultat du précédent, le traite (double) et passe le gestionnaire suivant.
 4. ...et ainsi de suite.
+=======
+Here the flow is:
+1. The initial promise resolves in 1 second `(*)`,
+2. Then the `.then` handler is called `(**)`, which in turn creates a new promise (resolved with `2` value).
+3. The next `then` `(***)` gets the result of the previous one, processes it (doubles) and passes it to the next handler.
+4. ...and so on.
+>>>>>>> 4541b7af7584014a676da731f6e8774da5e059f6
 
 Lorsque le résultat est transmis le long de la chaîne de gestionnaires, nous pouvons voir une séquence d'appels `alert`: `1` -> `2` -> `4`.
 

1-js/11-async/08-async-await/article.md

@@ -303,8 +303,13 @@ Le mot-clé `async` devant une fonction a deux effets:
 
 Le mot-clé `await` devant une promesse fait en sorte que JavaScript attende jusqu'à ce que cette promesse se règle, puis:
 
+<<<<<<< HEAD
 1. Si c'est une erreur, l'exception est générée - comme si `throw error` était appelé à cet endroit précis.
 2. Sinon, il renvoie le résultat.
+=======
+1. If it's an error, an exception is generated — same as if `throw error` were called at that very place.
+2. Otherwise, it returns the result.
+>>>>>>> 4541b7af7584014a676da731f6e8774da5e059f6
 
 Ensemble, ils fournissent un cadre idéal pour écrire du code asynchrone facile à lire et à écrire.
 

1-js/13-modules/01-modules-intro/article.md

@@ -261,7 +261,11 @@ Comparez-le à des scripts sans module, là où il est un object global:
 
 Il existe également plusieurs différences de scripts spécifiques au navigateur avec `type="module"` par rapport aux scripts classiques.
 
+<<<<<<< HEAD
 Vous devriez peut-être ignorer cette section pour l'instant si vous lisez pour la première fois ou si vous n'utilisez pas JavaScript dans un navigateur.
+=======
+You may want to skip this section for now if you're reading for the first time, or if you don't use JavaScript in a browser.
+>>>>>>> 4541b7af7584014a676da731f6e8774da5e059f6
 
 ### Les modules sont différés