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

Sync with upstream @ 6ab384f

Author: HachemiH

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

@@ -8,9 +8,13 @@ Mais dans le navigateur, un utilisateur ne voit pas les erreurs par défaut. Ain
 
 Pour voir les erreurs et obtenir beaucoup d’informations utiles sur les scripts, les navigateurs intègrent des "outils de développement".
 
+<<<<<<< HEAD
 Le plus souvent, les développeurs se tournent vers Chrome ou Firefox pour le développement, car ces navigateurs disposent des meilleurs outils de développement. D'autres navigateurs fournissent également des outils de développement, parfois dotés de fonctions spéciales, mais jouent généralement le rôle de "rattrapage" pour Chrome ou Firefox. Donc, la plupart des gens ont un navigateur "favori" et passent à d'autres si un problème est spécifique au navigateur.
 
 Les outils de développement sont très puissants, ils possèdent de nombreuses fonctionnalités. Pour commencer, nous allons apprendre à les ouvrir, à examiner les erreurs et à exécuter des commandes 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/15-function-basics/article.md

@@ -412,7 +412,11 @@ Les fonctions utilisées *très souvent* portent parfois des noms ultra-courts.
 
 Par exemple le framework [jQuery](http://jquery.com) définit une fonction avec `$`. La librairie [LoDash](http://lodash.com/) a nommé sa fonction principale `_`.
 
+<<<<<<< HEAD
 Ce sont des exceptions. En règle générale, les noms de fonctions doivent être concis, mais descriptifs.
+=======
+These are exceptions. Generally function names should be concise and descriptive.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 ```
 
 ## Fonctions == Commentaires

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

@@ -2,6 +2,10 @@
 
 Les tests automatisés seront utilisés dans d'autres tâches. Ils sont également largement utilisés dans des projets réels.
 
+<<<<<<< HEAD
+=======
+## Why do we need tests?
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 ## Pourquoi avons-nous besoin de tests ?
 

1-js/03-code-quality/06-polyfills/article.md

@@ -48,7 +48,11 @@ Les systèmes de construction de projets modernes, tels que [webpack](http://web
 
 Les nouvelles fonctionnalités du langage peuvent inclure non seulement des constructions de syntaxe et des opérateurs, mais également des fonctions intégrées.
 
+<<<<<<< HEAD
 Par exemple, `Math.trunc(n)` est une fonction qui "coupe" la partie décimale d'un nombre, par exemple `Math.trunc(1.23) = 1`.
+=======
+For example, `Math.trunc(n)` is a function that "cuts off" the decimal part of a number, e.g `Math.trunc(1.23)` returns `1`.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 Dans certains moteurs JavaScript (très obsolètes), il n'y a pas de `Math.trunc`, donc un tel code échouera.
 

1-js/04-object-basics/04-object-methods/article.md

@@ -81,7 +81,11 @@ user = {
 // la méthode abrégée semble mieux, non ?
 user = {
 *!*
+<<<<<<< HEAD
   sayHi() { // identique à "sayHi: function()"
+=======
+  sayHi() { // same as "sayHi: function(){...}"
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 */!*
     alert("Hello");
   }

1-js/05-data-types/08-weakmap-weakset/article.md

@@ -1,6 +1,10 @@
 # WeakMap et WeakSet
 
+<<<<<<< HEAD
 Comme nous le savons du chapitre <info:garbage-collection>, le moteur JavaScript stocke une valeur en mémoire pendant qu'elle est accessible (et peut potentiellement être utilisée).
+=======
+As we know from the chapter <info:garbage-collection>, JavaScript engine keeps a value in memory while it is "reachable" and can potentially be used.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 Par exemple :
 ```js

1-js/05-data-types/09-keys-values-entries/article.md

@@ -98,4 +98,8 @@ let doublePrices = Object.fromEntries(
 alert(doublePrices.meat); // 8
 ```   
 
+<<<<<<< HEAD
 Cela peut sembler difficile au premier abord, mais il devient facile à comprendre après l’avoir utilisé une ou deux fois. Nous pouvons faire de puissantes chaînes de transformations de cette façon.
+=======
+It may look difficult at first sight, but becomes easy to understand after you use it once or twice. We can make powerful chains of transforms this way. 
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96

1-js/11-async/02-promise-basics/article.md

@@ -28,10 +28,17 @@ Ses arguments `resolve` (tenir) et `reject` (rompre) sont les fonctions de retou
 
 Quand l'exécuteur obtient un résultat, qu'il soit rapide ou pas, cela n'a pas d'importance, il appellera une des deux fonctions callbacks :
 
+<<<<<<< HEAD
 - `resolve(value)` -  si la tâche s'est terminée avec succés, avec le résultat `value`.
 - `reject(error)` - si une erreur est survenue, `error` est l'object erreur.
 
 Donc, pour résumer : l'exécuteur s'exécute automatiquement et effectue un travail. Ensuite, il devrait appeler `resolve` s'il a réussi ou `reject` s'il y avait une erreur.
+=======
+- `resolve(value)` — if the job is finished successfully, with result `value`.
+- `reject(error)` — if an error has occurred, `error` is the error object.
+
+So to summarize: the executor runs automatically and attempts to perform a job. When it is finished with the attempt, it calls `resolve` if it was successful or `reject` if there was an error.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 L'objet `promise` retourné par le constructeur `new Promise` a des propriétés internes :
 

1-js/11-async/07-microtask-queue/article.md

@@ -30,7 +30,11 @@ Comme indiqué dans la [spécification](https://tc39.github.io/ecma262/#sec-jobs
 - La file d'attente est premier entré, premier sorti: les tâches mises en file d'attente en premier sont exécutées en premier.
 - L'exécution d'une tâche est lancée uniquement lorsque rien d'autre n'est en cours d'exécution.
 
+<<<<<<< HEAD
 Ou, simplement, lorsqu'une promesse est prête, ses gestionnaires `.then/catch/finally` sont mis en file d'attente ; ils ne sont pas encore exécutés. Lorsque le moteur JavaScript est libéré du code actuel, il extrait une tâche de la file d'attente et l'exécute.
+=======
+Or, to put it more simply, when a promise is ready, its `.then/catch/finally` handlers are put into the queue; they are not executed yet. When the JavaScript engine becomes free from the current code, it takes a task from the queue and executes it.
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 C'est pourquoi "code finished" dans l'exemple ci-dessus s'affiche en premier.
 
@@ -40,7 +44,11 @@ Les gestionnaires de promesses passent toujours par cette file d'attente interne
 
 S'il existe une chaîne avec plusieurs `.then/catch/finally`, chacun d'entre eux est exécuté de manière asynchrone. C'est-à-dire qu'il est d'abord mis en file d'attente et exécuté lorsque le code actuel est terminé et que les gestionnaires précédemment placés en file d'attente sont terminés.
 
+<<<<<<< HEAD
 **Et si l'order importait pour nous ? Comment pouvons-nous faire en sorte que `code finished` s'exécute après `promise done` ?**
+=======
+**What if the order matters for us? How can we make `code finished` appear after `promise done`?**
+>>>>>>> 6ab384f2512902d74e4b0ff5a6be60e48ab52e96
 
 Facile, il suffit de le mettre dans la file d'attente avec `.then`:
 

1-js/12-generators-iterators/2-async-iterators-generators/article.md

@@ -384,6 +384,8 @@ Un exemple d'utilisation (montrant les auteurs de chaque commit en console) :
   }
 
 })();
+
+// Note: If you are running this in an external sandbox, you'll need to paste here the function fetchCommits described above 
 ```
 
 C'est exactement ce que nous voulions.