Merge pull request #217 from javascript-tutorial/sync-540d753e

Sync with upstream @ 540d753

Author: tmollov

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: iliakan

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

@@ -22,7 +22,7 @@
 
 Изглежда ето така:
 
-![chrome](chrome.png)
+![chrome](chrome.webp)
 
 Точният вид на инструментите за разработчици зависи от вашата версия на Chrome. Променя се от време на време, но би трябвало да е подобно на това.
 
@@ -49,7 +49,11 @@
 
 Safari (браузърът на OС Mac, не се поддържа от ОС Windows/Linux) е малко по-специфичен. Първо трябва да включите/позволите "менюто за разработване".
 
+<<<<<<< HEAD
 Отворете свойствата и отидете на панела "Advanced". Има отметка в дъното:
+=======
+Open Settings and go to the "Advanced" pane. There's a checkbox at the bottom:
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 ![safari](safari.png)
 

1-js/01-getting-started/4-devtools/chrome.png

@@ -93,16 +93,26 @@ let user = 'John'
 *!*var*/!* message = 'Hello';
 ```
 
+<<<<<<< HEAD
 Ключовата дума `var` е почти същото като на `let`. То също декларира променлива, но е малко по-различен, от стила на "старата школа".
 
 Има тънки различия между `let` и `var`, но засега те не ни засягат. Ще ги разгледаме подробно в главата <info:var>.
+=======
+The `var` keyword is *almost* the same as `let`. It also declares a variable but in a slightly different, "old-school" way.
+
+There are subtle differences between `let` and `var`, but they do not matter to us yet. We'll cover them in detail in the chapter <info:var>.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 ````
 
 ## Аналогия в реалния живот
 
 Лесно можем да схванем концепцията на "променливата", ако я представим като "кутия" с данни, с уникално именуван стикер върху нея.
 
+<<<<<<< HEAD
 Например, променливата `message` можем да си въобразим като кутия, наименуван като `"message"`, със стойност  `"Hello!"` в нея:
+=======
+For instance, the variable `message` can be imagined as a box labelled `"message"` with the value `"Hello!"` in it:
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 ![ ](variable.svg)
 
@@ -228,15 +238,23 @@ Variables named `apple` and `APPLE` are two different variables.
 ```
 
 ````smart header="Non-Latin letters are allowed, but not recommended"
+<<<<<<< HEAD
 It is possible to use any language, including cyrillic letters, Chinese logograms and so on, like this:
 >>>>>>> 5dff42ba283bce883428c383c080fa9392b71df8
+=======
+It is possible to use any language, including Cyrillic letters, Chinese logograms and so on, like this:
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 ```js
 let имя = '...';
 let 我 = '...';
 ```
 
+<<<<<<< HEAD
 Технически няма грешка тука, такива имена са позволени, но има международна традиция да се използва английския език при писане на имена на променливи. Дори ако пишем малък скрипт, това може да има дълъг живот за напред. На хората от други страни може да им се наложи да ги прочетат някое време.
+=======
+Technically, there is no error here. Such names are allowed, but there is an international convention to use English in variable names. Even if we're writing a small script, it may have a long life ahead. People from other countries may need to read it sometime.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 ````
 
 ````warn header="Запазени имена"
@@ -290,17 +308,25 @@ const myBirthday = '18.04.1982';
 myBirthday = '01.01.2001'; // грешка,  стойността не може да се промени
 ```
 
+<<<<<<< HEAD
 <<<<<<< HEAD
 Когато програмистите са сигурни в това, че стойността на променливата никога няма да се промени, тогава те могат да ги декларират с `const` за да са гарантирани в това и ясно да съобщават този факт с всички.
 
 ### Константи с главна буква
 =======
 When a programmer is sure that a variable will never change, they can declare it with `const` to guarantee and clearly communicate that fact to everyone.
+=======
+When a programmer is sure that a variable will never change, they can declare it with `const` to guarantee and communicate that fact to everyone.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 ### Uppercase constants
 >>>>>>> 5dff42ba283bce883428c383c080fa9392b71df8
 
+<<<<<<< HEAD
 Има широко разпространена практика да се използват константи като псевдоними за трудно запомнящи се стойности, които са известни преди изпълнението.
+=======
+There is a widespread practice to use constants as aliases for difficult-to-remember values that are known before execution.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 Такива константи се назовават с главни букви и подчертаване.
 
@@ -325,7 +351,11 @@ alert(color); // #FF7F00
 
 Кога трябва да използваме главни букви за константа и кога трябва да я наименуваме нормално? Нека да поясним това.
 
+<<<<<<< HEAD
 Това, че "константа", просто означава, че стойността на променливата никога не се променя. Но има константи, които са известни с приоритет преди изпълнението (като шестнадесетична стойност за червено) и има константи, които се *изчисляват* по време на изпълнение, по време на екзекуция на скрипта, но не се променят след първоначалното им присвояване.
+=======
+Being a "constant" just means that a variable's value never changes. But some constants are known before execution (like a hexadecimal value for red) and some constants are *calculated* in run-time, during the execution, but do not change after their initial assignment.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 <<<<<<< HEAD
 Например:
@@ -337,7 +367,11 @@ For instance:
 const pageLoadTime = /* времето, което се е заредил уеб страницата */;
 ```
 
+<<<<<<< HEAD
 Стойността на „pageLoadTime“ не е известна преди зареждането на страницата, така че се наименуван нормално. Но тя все още е константа, защото не се променя след присвояването.
+=======
+The value of `pageLoadTime` is not known before the page load, so it's named normally. But it's still a constant because it doesn't change after the assignment.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 <<<<<<< HEAD
 С други думи, константи наименувани с главна буква се използват само като псевдоними за "hard-coded" (или кодирани ръчно) стойности.
@@ -351,18 +385,31 @@ In other words, capital-named constants are only used as aliases for "hard-coded
 
 Името на променливата трябва да има чисто и  очевидно значение, описващо данните, което съхранява.
 
+<<<<<<< HEAD
 Наименуването на променливите е едно от най-важните и сложни умения в програмирането. Бърз поглед към имената на променливите може да разкрие кой код е написан от начинаещ или опитен разработчик.
 
 В реален проект по-голямата част от времето се изразходва за модифициране и разширяване на съществуваща кодова база, а не за писане на нещо напълно отделно от нулата. Когато се върнем към някакъв код, след като направим нещо друго за известно време, е много по-лесно да намерим информация, която е добре етикетирана. Или с други думи, когато променливите имат добри имена.
+=======
+Variable naming is one of the most important and complex skills in programming. A glance at variable names can reveal which code was written by a beginner versus an experienced developer.
+
+In a real project, most of the time is spent modifying and extending an existing code base rather than writing something completely separate from scratch. When we return to some code after doing something else for a while, it's much easier to find information that is well-labelled. Or, in other words, when the variables have good names.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 Моля, отделете време за размисъл за правилното име за променливата, преди да я декларирате. Ако направите това, ще ви се отплати щедро.
 
 Някои добри правила за да следваме са:
 
+<<<<<<< HEAD
 - Използвайте лесно четими имена за човека като `userName` или `shoppingCart`.
 - Стойте далеч от съкращения или кратки имена като `a`, `b`, `c`, освен ако наистина знаеш какво правиш.
 - Направете имената максимално описателни и кратки. Примери за лоши имена са `data` и `value`. Такива имена не казват нищо. Добре е да ги използвате само ако контекстът на кода прави изключително очевидно към кои данни или стойности реферират променливите.
 - Съгласете се за условията в рамките на вашия екип и в собствения си ум. Ако посетителят на сайта се нарича `user`, тогава трябва да назовем подобни променливи `currentUser` или `newUser` вместо `currentVisitor` или `newManInTown`.
+=======
+- Use human-readable names like `userName` or `shoppingCart`.
+- Stay away from abbreviations or short names like `a`, `b`, and `c`, unless you know what you're doing.
+- Make names maximally descriptive and concise. Examples of bad names are `data` and `value`. Such names say nothing. It's only okay to use them if the context of the code makes it exceptionally obvious which data or value the variable is referencing.
+- Agree on terms within your team and in your mind. If a site visitor is called a "user" then we should name related variables `currentUser` or `newUser` instead of `currentVisitor` or `newManInTown`.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 Звучи просто? Наистина е така, но създаването на описателни и кратки имена на променливи на практика не е така. Пробвайте го.
 

1-js/01-getting-started/4-devtools/chrome.webp

@@ -108,13 +108,17 @@ const bigInt = 1234567890123456789012345678901234567890n;
 
 Тъй като номерата на BigInt рядко са необходими, ние не ги обхващаме тук, а им посвещаваме отделна глава <info:bigint>. Прочетете го, когато имате нужда от толкова големи числа.
 
+<<<<<<< HEAD
 ```smart header="Проблеми със съвместимостта"
 В момента `BigInt` се поддържа в Firefox / Chrome / Edge / Safari, но не и в IE.
 ```
 
 Можете да проверите [таблицата за съвместимост на BigInt](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt#Browser_compatibility), за да знаете кои версии на браузърите се поддържат.
 
 ## Низ
+=======
+## String
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 Низовете в JavaScript трябва да бъде в кавички.
 

1-js/01-getting-started/4-devtools/chrome@2.webp

@@ -108,7 +108,7 @@ let sayHi = function() { // (1) create
 >>>>>>> c5358c59494b53efb832c81a5338e0a23b22c269
 };
 
-let func = sayHi;
+let func = sayHi;  //(2)
 // ...
 ```
 

1-js/01-getting-started/4-devtools/chrome@2x.png

@@ -15,7 +15,11 @@ The JavaScript language steadily evolves. New proposals to the language appear r
 So it's quite common for an engine to implement only part of the standard.
 >>>>>>> 5dff42ba283bce883428c383c080fa9392b71df8
 
+<<<<<<< HEAD
 Добър ресурс, където може да видите кои свойства на езика се поддържат към настоящия момент е  <https://kangax.github.io/compat-table/es6/> (доста е голям, а ние имаме да учим още много).
+=======
+A good page to see the current state of support for language features is <https://compat-table.github.io/compat-table/es6/> (it's big, we have a lot to study yet).
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 Като програмисти, бихме искали да използваме най-новите налични функции. Колкото повече добри неща - толкова по-добре!
 
@@ -106,13 +110,17 @@ JavaScript е силно динамичен език, скриптовете м
 =======
 JavaScript is a highly dynamic language. Scripts may add/modify any function, even built-in ones.
 
+<<<<<<< HEAD
 Two interesting polyfill libraries are:
 - [core js](https://github.com/zloirock/core-js) that supports a lot, allows to include only needed features.
 - [polyfill.io](https://polyfill.io/) service that provides a script with polyfills, depending on the features and user's browser.
 >>>>>>> 5dff42ba283bce883428c383c080fa9392b71df8
 
 - [core js](https://github.com/zloirock/core-js), който поддържа много, позволява да се включват само необходимите функции.
 - [polyfill.io](http://polyfill.io) услуга, която предоставя скрипт с полифили, в зависимост от функциите и браузъра на потребителя.
+=======
+One interesting polyfill library is [core-js](https://github.com/zloirock/core-js), which supports a wide range of features and allows you to include only the ones you need.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 ## Обобщение
 
@@ -132,7 +140,13 @@ Just don't forget to use a transpiler (if using modern syntax or operators) and
 For example, later when you're familiar with JavaScript, you can setup a code build system based on [webpack](https://webpack.js.org/) with the [babel-loader](https://github.com/babel/babel-loader) plugin.
 >>>>>>> 5dff42ba283bce883428c383c080fa9392b71df8
 
+<<<<<<< HEAD
 Добри ресурси, които показват текущото състояние на поддръжка за различните нови функции:
+=======
+Good resources that show the current state of support for various features:
+- <https://compat-table.github.io/compat-table/es6/> - for pure JavaScript.
+- <https://caniuse.com/> - for browser-related functions.
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 
 - <https://kangax.github.io/compat-table/es6/> - за чист JavaScript.
 - <https://caniuse.com/> - за функции, свързани с браузъра.

1-js/01-getting-started/4-devtools/safari.png

@@ -4,7 +4,7 @@ importance: 2
 
 # Chaining
 
-There's a `ladder` object that allows to go up and down:
+There's a `ladder` object that allows you to go up and down:
 
 ```js
 let ladder = {
@@ -21,7 +21,7 @@ let ladder = {
 };
 ```
 
-Now, if we need to make several calls in sequence, can do it like this:
+Now, if we need to make several calls in sequence, we can do it like this:
 
 ```js
 ladder.up();
@@ -32,10 +32,10 @@ ladder.down();
 ladder.showStep(); // 0
 ```
 
-Modify the code of `up`, `down` and `showStep` to make the calls chainable, like this:
+Modify the code of `up`, `down`, and `showStep` to make the calls chainable, like this:
 
 ```js
 ladder.up().up().down().showStep().down().showStep(); // shows 1 then 0
 ```
 
-Such approach is widely used across JavaScript libraries.
+Such an approach is widely used across JavaScript libraries.

1-js/01-getting-started/4-devtools/safari@2x.png

@@ -354,7 +354,11 @@ let obj = {
   }
 };
 
+<<<<<<< HEAD
 alert(obj + 2); // 22 ("2" + 2), преобразуване в примитивен връща низ => конкатенация
+=======
+alert(obj + 2); // "22" ("2" + 2), conversion to primitive returned a string => concatenation
+>>>>>>> 540d753e90789205fc6e75c502f68382c87dea9b
 ```
 
 ## Обобщение