merging all conflicts

Author: iliakan

.github/FUNDING.yml

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

.gitignore

@@ -21,3 +21,4 @@ sftp-config.json
 Thumbs.db
 
 
+/svgs

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

@@ -1,22 +1,35 @@
 
 # Справочники и спецификации
 
+<<<<<<< HEAD
 Эта книга является *учебником* и нацелена на то, чтобы помочь вам постепенно освоить язык. Но когда вы хорошо изучите основы, вам понадобятся дополнительные источники информации.
+=======
+This book is a *tutorial*. It aims to help you gradually learn the language. But once you're familiar with the basics, you'll need other resources.
+>>>>>>> 52c1e61915bc8970a950a3f59bd845827e49b4bf
 
 ## Спецификация
 
 [Спецификация ECMA-262](https://www.ecma-international.org/publications-and-standards/standards/ecma-262/) содержит самую глубокую, детальную и формализованную информацию о JavaScript. Она определяет сам язык.
 
 Вначале спецификация может показаться тяжеловатой для понимания из-за слишком формального стиля изложения. Если вы ищете источник самой достоверной информации, то это правильное место, но она не для ежедневного использования.
 
+<<<<<<< HEAD
 Новая версия спецификации появляется каждый год. А пока она не вышла официально, все желающие могут ознакомиться с текущим черновиком на <https://tc39.es/ecma262/>.
+=======
+A new specification version is released every year. Between these releases, the latest specification draft is at <https://tc39.es/ecma262/>.
+>>>>>>> 52c1e61915bc8970a950a3f59bd845827e49b4bf
 
 Чтобы почитать о самых последних возможностях, включая те, которые "почти в стандарте" (так называемые "stage 3 proposals"), посетите <https://github.com/tc39/proposals>.
 
+<<<<<<< HEAD
 Если вы разрабатываете под браузеры, то существуют и другие спецификации, о которых рассказывается во [второй части](info:browser-environment) этого учебника.
+=======
+Also, if you're developing for the browser, then there are other specifications covered in the [second part](info:browser-environment) of the tutorial.
+>>>>>>> 52c1e61915bc8970a950a3f59bd845827e49b4bf
 
 ## Справочники
 
+<<<<<<< HEAD
 - **MDN (Mozilla) JavaScript Reference** -- это справочник с примерами и другой информацией. Хороший источник для получения подробных сведений о функциях языка, методах встроенных объектов и так далее.
 
     Располагается по адресу <https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference>.
@@ -28,10 +41,28 @@
 JavaScript -- это развивающийся язык, в который постоянно добавляется что-то новое.
 
 Посмотреть, какие возможности поддерживаются в разных браузерах и других движках, можно в следующих источниках:
+=======
+- **MDN (Mozilla) JavaScript Reference** is the main manual with examples and other information. It's great to get in-depth information about individual language functions, methods etc.
+
+    You can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
+
+Although, it's often best to use an internet search instead. Just use "MDN [term]" in the query, e.g. <https://google.com/search?q=MDN+parseInt> to search for the `parseInt` function.
+>>>>>>> 52c1e61915bc8970a950a3f59bd845827e49b4bf
 
 - <https://caniuse.com> - таблицы с информацией о поддержке по каждой возможности языка. Например, чтобы узнать, какие движки поддерживают современные криптографические функции, посетите: <https://caniuse.com/#feat=cryptography>.
 - <https://kangax.github.io/compat-table> - таблица с возможностями языка и движками, которые их поддерживают и не поддерживают.
 
 Все эти ресурсы полезны в ежедневной работе программиста, так как они содержат ценную информацию о возможностях использования языка, их поддержке и так далее.
 
+<<<<<<< HEAD
 Пожалуйста, запомните эти ссылки (или ссылку на эту страницу) на случай, когда вам понадобится подробная информация о какой-нибудь конкретной возможности JavaScript.
+=======
+To see their support among browser-based and other engines, see:
+
+- <https://caniuse.com> - per-feature tables of support, e.g. to see which engines support modern cryptography functions: <https://caniuse.com/#feat=cryptography>.
+- <https://kangax.github.io/compat-table> - a table with language features and engines that support those or don't support.
+
+All these resources are useful in real-life development, as they contain valuable information about language details, their support, etc.
+
+Please remember them (or this page) for the cases when you need in-depth information about a particular feature.
+>>>>>>> 52c1e61915bc8970a950a3f59bd845827e49b4bf

1-js/01-getting-started/2-manuals-specifications/article.md

@@ -12,8 +12,13 @@ IDE загружает проект (который может состоять
 
 Если вы ещё не выбрали себе IDE, присмотритесь к этим:
 
+<<<<<<< HEAD
 - [Visual Studio Code](https://code.visualstudio.com/) (кросс-платформенная, бесплатная).
 - [WebStorm](https://www.jetbrains.com/webstorm/) (кросс-платформенная, бесплатная для некоммерческого использования).
+=======
+- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free).
+- [WebStorm](https://www.jetbrains.com/webstorm/) (cross-platform, paid).
+>>>>>>> 52c1e61915bc8970a950a3f59bd845827e49b4bf
 
 Для Windows есть ещё Visual Studio (не путать с Visual Studio Code). Visual Studio - это платная мощная среда разработки, которая работает только на Windows. Она хорошо подходит для .NET платформы. У неё есть бесплатная версия, которая называется [Visual Studio Community](https://www.visualstudio.com/vs/community/).
 
@@ -29,16 +34,33 @@ IDE загружает проект (который может состоять
 
 На практике "лёгкие" редакторы могут иметь множество плагинов, включая автодополнение и анализаторы синтаксиса на уровне директории, поэтому границы между IDE и "лёгкими" редакторами размыты.
 
+<<<<<<< HEAD
 Следующие варианты заслуживают вашего внимания:
 
 - [Sublime Text](https://www.sublimetext.com) (кроссплатформенный, условно-бесплатный).
 - [Notepad++](https://notepad-plus-plus.org/) (Windows, бесплатный).
 - [Vim](https://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.
+>>>>>>> 52c1e61915bc8970a950a3f59bd845827e49b4bf
 
 ## Не будем ссориться
 
 Редакторы, перечисленные выше, известны автору давно и заслужили много хороших отзывов от коллег.
 
 Конечно же, есть много других отличных редакторов. Выбирайте тот, который вам больше нравится.
 
+<<<<<<< HEAD
 Выбор редактора, как и любого другого инструмента, индивидуален и зависит от ваших проектов, привычек и личных предпочтений.
+=======
+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).
+>>>>>>> 52c1e61915bc8970a950a3f59bd845827e49b4bf

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

@@ -22,14 +22,22 @@ Chrome и Firefox снискали любовь подавляющего бол
 
 Она выглядит приблизительно следующим образом:
 
+<<<<<<< HEAD
 ![](chrome.webp)
+=======
+![chrome](chrome.webp)
+>>>>>>> 52c1e61915bc8970a950a3f59bd845827e49b4bf
 
 Точный внешний вид инструментов разработки зависит от используемой версии Chrome. Время от времени некоторые детали изменяются, но в целом внешний вид остаётся примерно похожим на предыдущие версии.
 
 - В консоли мы можем увидеть сообщение об ошибке, отрисованное красным цветом. В нашем случае скрипт содержит неизвестную команду "lalala".
 - Справа присутствует ссылка на исходный код `bug.html:12` с номером строки кода, в которой эта ошибка и произошла.
 
+<<<<<<< HEAD
 Под сообщением об ошибке находится синий символ `>`. Он обозначает командную строку, в ней мы можем редактировать и запускать JavaScript-команды. Для их запуска нажмите `key:Enter`.
+=======
+Below the error message, there is a blue `>` symbol. It marks a "command line" where we can type JavaScript commands. Press `key:Enter` to run them.
+>>>>>>> 52c1e61915bc8970a950a3f59bd845827e49b4bf
 
 ```smart header="Многострочный ввод"
 Обычно при нажатии `key:Enter` введённая строка кода сразу выполняется.
@@ -39,6 +47,11 @@ Chrome и Firefox снискали любовь подавляющего бол
 
 Теперь мы явно видим ошибки, для начала этого вполне достаточно. Мы ещё вернёмся к инструментам разработчика позже и более подробно рассмотрим отладку кода в главе <info:debugging-chrome>.
 
+```smart header="Multi-line input"
+Usually, when we put a line of code into the console, and then press `key:Enter`, it executes.
+
+To insert multiple lines, press `key:Shift+Enter`. This way one can enter long fragments of JavaScript code.
+```
 
 ## Firefox, Edge и другие
 
@@ -50,15 +63,28 @@ Chrome и Firefox снискали любовь подавляющего бол
 
 Safari (браузер для Mac, не поддерживается в системах Windows/Linux) всё же имеет небольшое отличие. Для начала работы нам нужно включить "Меню разработки" ("Developer menu").
 
+<<<<<<< HEAD
 Откройте Настройки (Preferences) и перейдите к панели "Продвинутые" (Advanced). В самом низу вы найдёте чекбокс:
+=======
+Open Settings and go to the "Advanced" pane. There's a checkbox at the bottom:
+>>>>>>> 52c1e61915bc8970a950a3f59bd845827e49b4bf
 
 ![](safari.png)
 
 Теперь консоль можно активировать нажатием клавиш `key:Cmd+Opt+C`. Также обратите внимание на новый элемент меню "Разработка" ("Develop"). В нем содержится большое количество команд и настроек.
 
+<<<<<<< HEAD
 ## Итого
 
 - Инструменты разработчика позволяют нам смотреть ошибки, выполнять команды, проверять значение переменных и ещё много всего полезного.
 - В большинстве браузеров, работающих под Windows, инструменты разработчика можно открыть, нажав `key:F12`. В Chrome для Mac используйте комбинацию `key:Cmd+Opt+J`, Safari: `key:Cmd+Opt+C` (необходимо предварительное включение "Меню разработчика").
 
 Теперь наше окружение полностью настроено. В следующем разделе мы перейдём непосредственно к JavaScript.
+=======
+## Summary
+
+- Developer tools allow us to see errors, run commands, examine variables, and much more.
+- They can be opened with `key:F12` for most browsers on Windows. Chrome for Mac needs `key:Cmd+Opt+J`, Safari: `key:Cmd+Opt+C` (need to enable first).
+
+Now we have the environment ready. In the next section, we'll get down to JavaScript.
+>>>>>>> 52c1e61915bc8970a950a3f59bd845827e49b4bf

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

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+
+<body>
+
+  <script>
+    alert( "I'm JavaScript!" );
+  </script>
+
+</body>
+
+</html>

1-js/01-getting-started/4-devtools/[email protected]

@@ -0,0 +1,2 @@
+
+[html src="index.html"]