Sync with upstream @ 3d7abb9c

.github/FUNDING.yml

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

1-js/01-getting-started/3-code-editors/article.md

@@ -29,16 +29,35 @@ Windows үчүн Visual Studio да бар (Visual Studio Code менен чат
 
 Иш жүзүндө "жеңил" редакторлор көптөгөн плагиндерге, анын ичинде директория деңгээлиндеги синтаксис анализаторлору жана автокошумчалоолору ээ болушу мүмкүн, ошондуктан "жеңил" редактор менен IDE ортосунда катуу чеги жок.
 
+<<<<<<< HEAD
 Төмөнкү варианттар сиздин көңүлүңүздү бурууга татыктуу:
 - [Atom](https://atom.io) (кроссплатформалуу, акысыз)
 - [Sublime Text](http://www.sublimetext.com) (кроссплатформалуу, шарттуу акысыз).
 - [Notepad++](https://notepad-plus-plus.org/) (Windows, акысыз).
 - [Vim](http://www.vim.org/) жана [Emacs](https://www.gnu.org/software/emacs/) кантип колдонгонун билсеңиз, алар да жакшы.
 
 ## Жаңжалдашпайлы
+=======
+There are many options, for instance:
+
+- [Sublime Text](https://www.sublimetext.com/) (cross-platform, shareware).
+- [Notepad++](https://notepad-plus-plus.org/) (Windows, free).
+- [Vim](https://www.vim.org/) and [Emacs](https://www.gnu.org/software/emacs/) are also cool if you know how to use them.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 Жогоруда саналган редакторлор авторго көптөн бери белгилүү жана кесиптештеринин көптөгөн жакшы пикирлерине ээ болушкан.
 
 Албетте, башка көптөгөн сонун редакторлор бар. Сизге эң жактырганын тандаңыз.
 
+<<<<<<< HEAD
 Башка куралды сыяктуу эле редакторду тандоо жеке иш болуп саналат жана долбоорлоруңузга, адаттарыңызга жана жеке каалоолоруңузга жараша болот.
+=======
+There are other great editors in our big world. Please choose the one you like the most.
+
+The choice of an editor, like any other tool, is individual and depends on your projects, habits, and personal preferences.
+
+The author's personal opinion:
+
+- I'd use [Visual Studio Code](https://code.visualstudio.com/) if I develop mostly frontend.
+- Otherwise, if it's mostly another language/platform and partially frontend, then consider other editors, such as XCode (Mac), Visual Studio (Windows) or Jetbrains family (Webstorm, PHPStorm, RubyMine etc, depending on the language).
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6

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

@@ -88,16 +88,26 @@ let user = 'Жакыя'
 *!*var*/!* message = 'Салам';
 ```
 
+<<<<<<< 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>.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 ````
 
 ## Жашоодогу аналогия
 
 Эгерде өзгөрмөнү берилмелер үчүн уникалдуу аталышы бар "куту" катары элестетсек, биз "өзгөрмө" түшүнүгүн оңой эле түшүнө алабыз.
 
+<<<<<<< HEAD
 Мисалы үчүн, `message` өзгөрмөсүн `"билдирүү"` деп аталган жана анын ичиндеги `"Салам!"` мааниси бар куту катары элестетүүгө болот.
+=======
+For instance, the variable `message` can be imagined as a box labelled `"message"` with the value `"Hello!"` in it:
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 ![](variable.svg)
 
@@ -150,12 +160,21 @@ let message = "Ошол"; // SyntaxError: 'message' has already been declared
 Ошондуктан, биз өзгөрмөнү бир гана жолу жарыялап, ага `let`'сиз кайрылышыбыз керек.
 ````
 
+<<<<<<< HEAD
 ```smart header="Функционалдуу тилдер"
 Өзгөрмө маанилерин өзгөртүүгө тыюу салган [Scala](http://www.scala-lang.org/) же [Erlang](http://www.erlang.org/) сыяктуу [функционалдуу](https://en.wikipedia.org/wiki/Functional_programming) программалоо тилдери бар экенин белгилей кетүү кызык.
+=======
+```smart header="Functional languages"
+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.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 Мындай тилдерде бир жолу "кутуда" сакталган маани түбөлүккө ошол жерде калат. Эгер башка нерсени сактоо керек болсо, тил бизди жаңы кутуча түзүүгө (жаңы өзгөрмө жарыялоого) мажбурлайт. Биз эски өзгөрмөнү колдоно албайбыз.
 
+<<<<<<< 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.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 ```
 
 ## Өзгөрмөлөрдү атоо [#variable-naming]
@@ -197,15 +216,24 @@ let my-name; // атта '-' дефисти коюуга болбойт
 `apple` жана `APPLE` деп аталган өзгөрмөлөр -- бул эки башка өзгөрмө.
 ```
 
+<<<<<<< HEAD
 ````smart header="Латын эмес тамгаларга уруксат берилет, бирок сунушталбайт"
 Каалаган тилди, анын ичинде кирил тамгаларын же жадаганда иероглифтерди колдонууга болот:
+=======
+````smart header="Non-Latin letters are allowed, but not recommended"
+It is possible to use any language, including Cyrillic letters, Chinese logograms and so on, like this:
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 ```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.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 ````
 
 ````warn header="Резервделген аттар"
@@ -260,11 +288,19 @@ const myBirthday = '18.04.1982';
 myBirthday = '01.01.2001'; // ката, константаны өзгөртүүгө болбойт!
 ```
 
+<<<<<<< HEAD
 Эгерде программист өзгөрмө эч качан өзгөрбөйт деп ишенсе, ал муну кепилдей алат жана аны `const` аркылуу жарыялоо менен ар бирине так кабарлай алат.
+=======
+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.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 ### Баш тамгадагы константалар
 
+<<<<<<< HEAD
 Скрипт аткарылганга чейин белгилүү болгон эстеп калууга кыйын маанилер үчүн константаларды тергеме ат катары колдонуу тажрыйбасы кеңири таралган.
+=======
+There is a widespread practice to use constants as aliases for difficult-to-remember values that are known before execution.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 Мындай константалардын аталыштары баш тамгалар жана ылдыйкы сызыкчалар менен жазылат.
 
@@ -289,15 +325,23 @@ 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.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 Мисалы үчүн:
 
 ```js
 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.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 Башкача айтканда, баш тамгалар менен аталган константалар "катуу коддолгон" маанилер үчүн тергеме ат катары гана колдонулат.
 
@@ -307,18 +351,31 @@ const pageLoadTime = /* веб-баракчаны жүктөөгө сарпта
 
 Өзгөрмөнүн аталышы ал сактаган берилмелерди сыпаттаган таза, анык мааниге ээ болушу керек.
 
+<<<<<<< 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.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 Сураныч, өзгөрмөнү жарыялоодон мурун анын туура аталышы жөнүндө ойлонууга убакыт бөлүңүз. Ушундай кылыңыз, ошондо сиз сыйланасыз.
 
 Бир нече жакшы эрежелер:
 
+<<<<<<< HEAD
 - `userName` же `shoppingCart` сыяктуу окууга оңой аттарды колдонуңуз.
 - Эмне кылып жатканыңызды так билбесеңиз, `a`, `b`, `c` сыяктуу кыскартуулардан же кыска аталыштардан алыс болуңуз.
 - Аттарды максималдуу түрдө сыпаттоочу жана кыска кылыңыз. Жаман аттардын мисалдары: `data` жана `value`. Мындай ысымдар эч нерсени айтпайт. Аларды коддун контекстинен өзгөрмө кандай маалыматтарды сактай турганы анык болсо гана колдонсо болот.
 - Колдонулган терминдер боюнча командаңыз менен макулдашыңыз. Эгер сайтка кирүүчү "user" деп аталса, анда аны менен байланышкан өзгөрмөлөрдү, мисалы, `currentVisitor` же `newManInTown` эмес, `currentUser` же `newUser` деп аташыбыз керек.
+=======
+- 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`.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 Жөнөкөй угулабы? Чынында эле ошондой, бирок тажрыйбада түшүнүктүү жана кыска өзгөрмө аттарын түзүү -- бул сейректик. Алга.
 

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

@@ -92,13 +92,17 @@ const bigInt = 1234567890123456789012345678901234567890n;
 
 `BigInt` сандары сейрек талап кылынгандыктан, биз аларды бөлөк <info:bigint> бөлүмүндө караштырабыз. Ушунчалык чоң сандар керек болгондо аны окуңуз.
 
+<<<<<<< HEAD
 ```smart header="Шайкештик көйгөйлөрү"
 Азыркы учурда `BigInt` Firefox/Chrome/Edge/Safari браузерлеринде колдоого алынат, бирок IE'де - жок.
 ```
 
 я Браузердин кайсы версиялары колдоого алынарын билүү үчүн [*MDN* BigInt шайкештик жадыбалын](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt#Browser_compatibility) карап көрсөңүз болот.
 
 ## Сап (string)
+=======
+## String
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 JavaScript'те сап тырмакчага алынышы керек.
 
@@ -222,7 +226,11 @@ alert(age); // "undefined"
 
 ## typeof оператору [#type-typeof]
 
+<<<<<<< HEAD
 `typeof` оператору аргументинин түрүн кайтарат. Бул ар кандай түрдөгү маанилерди башкача иштеткибиз келгенде же жөн гана тез текшерүүнү каалаганыбызда пайдалуу.
+=======
+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.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 `typeof x` чалуусу түрү аталышы менен сапты кайтарат:
 

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

@@ -34,7 +34,11 @@ alert(typeof value); // string
 
 ## Санга айландыруу
 
+<<<<<<< HEAD
 Сандарга айландыруу математикалык функцияларда жана туюнтмаларда автоматтык түрдө ишке ашат.
+=======
+Numeric conversion in mathematical functions and expressions happens automatically.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 Мисалы, бөлүү `/` сандар эместерге колдонулганда:
 

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
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 ```
 
 ### Даражага көтөрүү **
@@ -68,7 +74,11 @@ alert( 2 ** 3 ); // 2³ = 8
 alert( 2 ** 4 ); // 2⁴ = 16
 ```
 
+<<<<<<< HEAD
 Математикадагыдай эле, даражага көтөрүү операторун бөлчөктүк сандар үчүн да колдонууга болот.
+=======
+Just like in maths, the exponentiation operator is defined for non-integer numbers as well.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 Мисалы, чарчы тамыр бул ½ даражага көтөрүүсү:
 
@@ -80,7 +90,11 @@ alert( 8 ** (1/3) ); // 2 (1/3 даражасы кубдук тамыр мене
 
 ## Бинардык + менен саптарды кошуу
 
+<<<<<<< HEAD
 Келгиле, мектеп арифметикасынын алкагына кирбеген JavaScript операторлорунун өзгөчөлүктөрү менен таанышалы.
+=======
+Let's meet the features of JavaScript operators that are beyond school arithmetics.
+>>>>>>> 3d7abb9cc8fa553963025547717f06f126c449b6
 
 Адатта, плюс оператору `+` сандарды кошот.
 
@@ -308,7 +322,7 @@ let n = 2;
 
 n *= 3 + 5; // алгач оң бөлүгү эсептелинет, n *= 8 менен бирдей
 
-alert( n ); // 16  
+alert( n ); // 16
 ```
 
 ## Инкремент/декремент