Merge pull request #172 from javascript-tutorial/sync-285083fc

Sync with upstream @ 285083f

Author: tmollov

1-js/02-first-steps/04-variables/article.md

@@ -165,12 +165,20 @@ let message = "That"; // SyntaxError: 'message' has already been declared
 Интересно е да бележим, че съществува [функционални](https://bg.wikipedia.org/wiki/%D0%A4%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D0%BE%D0%BD%D0%B0%D0%BB%D0%BD%D0%BE_%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%B8%D1%80%D0%B0%D0%BD%D0%B5) програмни езици, като [Scala](http://www.scala-lang.org/) или [Erlang](http://www.erlang.org/), които забраняват промяната на стойностите на променливите.
 =======
 ```smart header="Functional languages"
+<<<<<<< HEAD
 It's interesting to note that there exist [functional](https://en.wikipedia.org/wiki/Functional_programming) programming languages, like [Scala](https://www.scala-lang.org/) or [Erlang](https://www.erlang.org/) that forbid changing variable values.
 >>>>>>> 5dff42ba283bce883428c383c080fa9392b71df8
+=======
+It's interesting to note that there exist so-called [pure functional](https://en.wikipedia.org/wiki/Purely_functional_programming) programming languages, such as [Haskell](https://en.wikipedia.org/wiki/Haskell), that forbid changing variable values.
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c
 
 При такива езици, веднъж когато стойността е запазена "в кутията", то е завинаги там. Ако се наложи да запазим нещо друго, езика ни принуждава да създадем нова кутия (да декларираме нова променлива). Не можем да използваме старата.
 
+<<<<<<< HEAD
 От пръв поглед може да ви се види малко странно, но тези езици са способни на доста сериозни разработки. Повече от това, има области като паралелни изчисления, където това ограничение носи определени ползи. Изучаване на подобен език (дори ако не планирате да го използвате скоро) се препоръчва, за да разширите знанията си.
+=======
+Though it may seem a little odd at first sight, these languages are quite capable of serious development. More than that, there are areas like parallel computations where this limitation confers certain benefits.
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c
 ```
 
 ## Именуване на променливи [#variable-naming]

1-js/02-first-steps/05-types/article.md

@@ -239,7 +239,11 @@ alert(age); // "undefined"
 
 `typeof` оператора връща типът, на даден аргумент. Той е полезен, когато искаме да обработим данни от различен тип, по различен начин или просто искаме да проверим типът на дадени данни.
 
+<<<<<<< HEAD
 Оператора може да бъде използван по два начина:
+=======
+The `typeof` operator returns the type of the operand. It's useful when we want to process values of different types differently or just want to do a quick check.
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c
 
 <<<<<<< HEAD
 1. Като оператор: `typeof x`.

1-js/02-first-steps/07-type-conversions/article.md

@@ -39,7 +39,11 @@ alert(typeof value); // символен низ
 
 ## Преубразуване в число(number)
 
+<<<<<<< HEAD
 Преобразуването в число се случва автоматично в математически функции и изрази.
+=======
+Numeric conversion in mathematical functions and expressions happens automatically.
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c
 
 Например, когато делене `/` се използва с нечислов тип:
 

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

@@ -50,8 +50,14 @@
 Например:
 
 ```js run
+<<<<<<< HEAD
 alert( 5 % 2 ); // 1, остатък от 5, разделен на 2
 alert( 8 % 3 ); // 2, остатък от 8, разделен на 3
+=======
+alert( 5 % 2 ); // 1, the remainder of 5 divided by 2
+alert( 8 % 3 ); // 2, the remainder of 8 divided by 3
+alert( 8 % 4 ); // 0, the remainder of 8 divided by 4
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c
 ```
 
 ### Степенуване **
@@ -68,7 +74,13 @@ alert( 2 ** 3 ); // 8  (2 * 2 * 2, 3 пъти)
 alert( 2 ** 4 ); // 16 (2 * 2 * 2 * 2, 4 пъти)
 ```
 
+<<<<<<< HEAD
 Математически, експоненцията е дефинирана и за нецелочислени числа. Например, квадратен корен е експоненция от `1/2`:
+=======
+Just like in maths, the exponentiation operator is defined for non-integer numbers as well.
+
+For example, a square root is an exponentiation by ½:
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c
 
 ```js run
 alert( 4 ** (1/2) ); // 2 (степен на 1/2 е същата като квадратен корен)
@@ -335,11 +347,15 @@ let n = 2;
 
 n *= 3 + 5; // right part evaluated first, same as n *= 8
 
+<<<<<<< HEAD
 <<<<<<< HEAD
 alert( n ); // 16  (дясната част се изчислява първо, същото като n *= 8)
 =======
 alert( n ); // 16  
 >>>>>>> 5dff42ba283bce883428c383c080fa9392b71df8
+=======
+alert( n ); // 16
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c
 ```
 
 ## Увеличаване/Намаляване

1-js/02-first-steps/10-ifelse/article.md

@@ -68,9 +68,13 @@ if (cond) {
 
 ## Клаузата "else"
 
+<<<<<<< HEAD
 Изразът `if` може да съдържа незадължителен блок `else`. Той се изпълнява, когато условието е невярно.
 
 Например:
+=======
+The `if` statement may contain an optional `else` block. It executes when the condition is falsy.
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c
 
 ```js run
 let year = prompt('Коя година са публикувани спецификациите на ECMAScript-2015?', '');
@@ -184,10 +188,17 @@ alert( message );
 
 В началото може да е трудно да разберете какво се случва. Но след по-подробно разглеждане можем да видим, че това е просто обикновена последователност от тестове:
 
+<<<<<<< HEAD
 1. Първият терминален оператор проверява `age < 3`.
 2. Ако е вярно -- връща `'Здравей, бебчо!'`. Иначе продължава израза след '":"', проверявайки `age < 18`.
 3. Ако е вярно -- връща `'Здравей!'`. Иначе продължава израза след '":"', проверявайки `age < 100`.
 4. Ако е вярно -- връща `'Поздрави!'`. Иначе продължава израза след '":"', и връща `'Каква необичайна възраст!'`.
+=======
+1. The first question mark checks whether `age < 3`.
+2. If true -- it returns `'Hi, baby!'`. Otherwise, it continues to the expression after the colon ":", checking `age < 18`.
+3. If that's true -- it returns `'Hello!'`. Otherwise, it continues to the expression after the next colon ":", checking `age < 100`.
+4. If that's true -- it returns `'Greetings!'`. Otherwise, it continues to the expression after the last colon ":", returning `'What an unusual age!'`.
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c
 
 Ето как изглежда ако бихме използвали `if..else`:
 

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

@@ -48,7 +48,7 @@ alert(user ?? "Anonymous"); // Anonymous (user is undefined)
 ```js run
 let user = "John";
 
-alert(user ?? "Anonymous"); // John (user is not null/udefined)
+alert(user ?? "Anonymous"); // John (user is not null/undefined)
 ```
 
 Можем да използваме и последователност от `??` за да изберем първата стойност от списък, който стойности не са `null/undefined`.
@@ -93,9 +93,13 @@ alert(firstName || lastName || nickName || "Anonymous"); // Supercoder
 */!*
 ```
 
+<<<<<<< HEAD
 ИЛИ `||` операторът съществува от началото на JavaScript, така че разработчиците го използваха за такива цели дълго време.
 
 От друга страна, нулевият условен оператор `??` е добавен към JavaScript едва наскоро, и причината за това беше, че хората не бяха съвсем доволни с `||`.
+=======
+Historically, the OR `||` operator was there first. It's been there since the beginning of JavaScript, so developers were using it for such purposes for a long time.
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c
 
 Важната разлика е в това:
 

1-js/02-first-steps/18-javascript-specials/article.md

@@ -107,6 +107,7 @@ typeof function(){} == "function" // функциите се третират с
 
 Ние използваме браузър като работна среда, така че обикновените функции на потребителския интерфейс ще са:
 
+<<<<<<< HEAD
 [`prompt(question, [default])`](mdn:api/Window/prompt)
 : Да попитаме за `question`, и да върнем това, което потребителят е въвел или `null` ако са натиснали "Cancel" (Отказ).
 
@@ -115,6 +116,16 @@ typeof function(){} == "function" // функциите се третират с
 
 [`alert(message)`](mdn:api/Window/alert)
 : Изпринтира `message`.
+=======
+[`prompt(question, [default])`](https://developer.mozilla.org/en-US/docs/Web/API/Window/prompt)
+: Ask a `question`, and return either what the visitor entered or `null` if they clicked "cancel".
+
+[`confirm(question)`](https://developer.mozilla.org/en-US/docs/Web/API/Window/confirm)
+: Ask a `question` and suggest to choose between Ok and Cancel. The choice is returned as `true/false`.
+
+[`alert(message)`](https://developer.mozilla.org/en-US/docs/Web/API/Window/alert)
+: Output a `message`.
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c
 
 Всички тези функции са *модални*, т.е. спират изпълнението на кода и не позволяват на посетителя да взаимодейства със страницата, докато не отговори.
 
@@ -152,8 +163,12 @@ JavaScript поддържа следните оператори:
 : Побитовите операции работят с 32 битови цели числа в най-ниското побитово ниво: погледнете [документацията](mdn:/JavaScript/Reference/Operators/Bitwise_Operators) когато ви e нужнo.
 =======
 Bitwise
+<<<<<<< HEAD
 : Bitwise operators work with 32-bit integers at the lowest, bit-level: see the [docs](mdn:/JavaScript/Guide/Expressions_and_Operators#bitwise_operators) when they are needed.
 >>>>>>> 5dff42ba283bce883428c383c080fa9392b71df8
+=======
+: Bitwise operators work with 32-bit integers at the lowest, bit-level: see the [docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Expressions_and_Operators#bitwise_operators) when they are needed.
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c
 
   ```js run
       alert(5 & 13); // 0101 & 1101 = 0101

1-js/04-object-basics/09-object-toprimitive/article.md

@@ -322,8 +322,12 @@ In contrast, `Symbol.toPrimitive` is stricter, it *must* return a primitive, oth
 =======
 If we pass an object as an argument, then there are two stages of calculations:
 1. The object is converted to a primitive (using the rules described above).
+<<<<<<< HEAD
 2. If the necessary for further calculations, the resulting primitive is also converted.
 >>>>>>> 5dff42ba283bce883428c383c080fa9392b71df8
+=======
+2. If necessary for further calculations, the resulting primitive is also converted.
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c
 
 Например:
 

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

@@ -811,7 +811,7 @@ alert( "S\u0307\u0323".normalize() == "\u1e68" ); // true
 
 - There are 3 types of quotes. Backticks allow a string to span multiple lines and embed expressions `${…}`.
 - We can use special characters, such as a line break `\n`.
-- To get a character, use: `[]`.
+- To get a character, use: `[]` or `at` method.
 - To get a substring, use: `slice` or `substring`.
 - To lowercase/uppercase a string, use: `toLowerCase/toUpperCase`.
 - To look for a substring, use: `indexOf`, or `includes/startsWith/endsWith` for simple checks.
@@ -830,4 +830,7 @@ alert( "S\u0307\u0323".normalize() == "\u1e68" ); // true
 Strings also have methods for doing search/replace with regular expressions. But that's big topic, so it's explained in a separate tutorial section <info:regular-expressions>.
 
 Also, as of now it's important to know that strings are based on Unicode encoding, and hence there're issues with comparisons. There's more about Unicode in the chapter <info:unicode>.
+<<<<<<< HEAD
 >>>>>>> 5dff42ba283bce883428c383c080fa9392b71df8
+=======
+>>>>>>> 285083fc71ee3a7cf55fd8acac9c91ac6f62105c

1-js/05-data-types/04-array/article.md

@@ -98,7 +98,7 @@ let fruits = [
 
 Let's say we want the last element of the array.
 
-Some programming languages allow to use negative indexes for the same purpose, like `fruits[-1]`.
+Some programming languages allow the use of negative indexes for the same purpose, like `fruits[-1]`.
 
 Although, in JavaScript it won't work. The result will be `undefined`, because the index in square brackets is treated literally.
 

1-js/05-data-types/05-array-methods/article.md

@@ -255,7 +255,7 @@ alert( arr.includes(1) ); // true
 
 Please note that `indexOf` uses the strict equality `===` for comparison. So, if we look for `false`, it finds exactly `false` and not the zero.
 
-If we want to check if `item` exists in the array, and don't need the exact index, then `arr.includes` is preferred.
+If we want to check if `item` exists in the array, and don't need the index, then `arr.includes` is preferred.
 
 The method [arr.lastIndexOf](mdn:js/Array/lastIndexOf) is the same as `indexOf`, but looks for from right to left.
 
@@ -338,8 +338,6 @@ alert(users.findIndex(user => user.name == 'John')); // 0
 alert(users.findLastIndex(user => user.name == 'John')); // 3
 ```
 
-
-
 ### filter
 
 The `find` method looks for a single (first) element that makes the function return `true`.