bakujsdevs · orkhan-huseyn · Nov 25, 2019 · Nov 25, 2019 · Nov 25, 2019 · Nov 25, 2019
diff --git a/1-js/01-getting-started/1-intro/article.md b/1-js/01-getting-started/1-intro/article.md
diff --git a/1-js/01-getting-started/1-intro/limitations.svg b/1-js/01-getting-started/1-intro/limitations.svg
diff --git a/1-js/01-getting-started/2-manuals-specifications/article.md b/1-js/01-getting-started/2-manuals-specifications/article.md
@@ -1,42 +1,40 @@
+# Manual və standartlar
 
-# Manuals and specifications
+Bu kitab sizin dil ilə tanışlığınıza və onu tədricən öyrənməyinizə yönəlmiş bir dərslikdir. Lakin dilin əsasları ilə tam tanış olduqdan sonra artıq başqa mənbələrə də ehtiyac duyacaqsınız. Gəlin bu cür mənbələrlə tanış olaq.
 
-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 sources.
+## Spesifikasiyalar
 
-## Specification
+[ECMA-262 standartları](https://www.ecma-international.org/publications/standards/Ecma-262.htm) JavaScript haqqında ən dərin, detallı və formal məlumatları ehtiva edir. Başqa sözlə desək, dili təyin edir.
 
-[The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information about JavaScript. It defines the language.
+Lakin bu spesifikasiyalar çox formal olduğu üçün bəzən anlaşılması çətin ola bilər. Spesifikasiyalar, JavaScript haqqında tapa biləcəyiniz ən güvənli və dəqiq məlumat mənbəyidir, hərçənd günlük istifadə üçün deyil.
 
-But being that formalized, it's difficult to understand at first. So if you need the most trustworthy source of information about the language details, the specification is the right place. But it's not for everyday use.
+Spesifikasiyanın hər il yeri versiyası yayımlanır. Ən son versiyası ilə [burada](https://tc39.es/ecma262/) tanış ola bilərsiniz.
 
-A new specification version is released every year. In-between these releases, the latest specification draft is at <https://tc39.es/ecma262/>.
+ECMA-262 standartlarına il boyunca yeni təkliflər verilir, bu təkliflər bir neçə mərhələdən keçdikdən sonra dilə əlavə olunur (standartlaşdırlır). Ən son təkliflər və "demək olar ki standartlaşdırılmış" (stage 3 proposals) xüsusiyyətlər ilə [burada](https://github.com/tc39/proposals) tanış ola bilərsiniz.
 
-To read about new bleeding-edge features, including those that are "almost standard" (so-called "stage 3"), see proposals at <https://github.com/tc39/proposals>.
+Bununla bərabar, əgər JavaScripti brauzer daxilində istifadə edirsinizsə bunun üçün başqa standartlar mövcuddur. Bu barədə dərsliyin [ikinci hissəsində](info:browser-environment) danışacağıq.
 
-Also, if you're in developing for the browser, then there are other specs covered in the [second part](info:browser-environment) of the tutorial.
+## Manuallar
 
-## Manuals
+- **MDN (Mozilla) JavaScript Reference**, nümunələr və digər məlumatlarla tanış ola biləcəyiniz başqa bir mənbədir. MDN, spesifik funksiya, obyektlər, metodlar və s. haqqında dərin məlumat əldə etmək və nümunələrlə tanış olmaq üçün əla yerdir.
 
-- **MDN (Mozilla) JavaScript Reference** is a manual with examples and other information. It's great to get in-depth information about individual language functions, methods etc.
+  Elə indi bu keçiddən istifadə edib baxmağınız tövsiyyə olunur: <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
 
-    One can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
+  Keçidə daxil olduqdan sonra sizin üçün axtardığınız şeyi tapmaq bir az çətin ola bilər. Bu səbəbdən, çox vaxt Google-da axtarış etmək daha əlverişli olar bilər. Misalçün, deyək ki, `parseInt` funksiyası haqqında ətraflı məlumat almaq istəyirsiniz, bunun üçün <https://google.com/search?q=MDN+parseInt> kimi axtarış edə bilərsiniz.
 
-    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 `parseInt` function.
+* **MSDN** – JavaScript (JScript deyək) və Microsoft-a məxsus digər şeylər haqqında məlumat toplaya biləcəyiniz əla mənbədir. Əgər Internet Explorer-ə xas bir şeylə bağlı məlumat almaq istəsəniz elə bura baxın: <http://msdn.microsoft.com/>.
 
+  Və təbii ki, sadə bir internet axtarışından da yararlana bilərsiniz. Misalçün, "RegExp MSDN" və ya "RegExp MSDN jscript".
 
-- **MSDN** – Microsoft manual with a lot of information, including JavaScript (often referred to as JScript). If one needs something specific to Internet Explorer, better go there: <http://msdn.microsoft.com/>.
+## Brauzer dəstəyi və uyğunluq cədvəlləri
 
-    Also, we can use an internet search with phrases such as "RegExp MSDN" or "RegExp MSDN jscript".
+JavaScript iknişafda olan bir dil olduğu üçün müntəzəm olaraq yeni xüsusiyyətlər əlavə olunur.
 
-## Compatibility tables
+Bu cür xüsusiyyətlərin müxtəlif brauzerlər və engine-lər tərəfindən nə dərəcədə dəstəkləndiyini öyrənmək üçün aşağıdakı resurslardan istifadə edin:
 
-JavaScript is a developing language, new features get added regularly.
+- <http://caniuse.com> - hər bir xüsusiyyətə görə brauzer dəstəyini göstərir. Misalçün, kriptokrafik funksiyaların hansı brauzerlər tərəfindən dəstəkləndiyini görmək üçün belə bir axtarış edə bilərsiniz: <http://caniuse.com/#feat=cryptography>.
+- <https://kangax.github.io/compat-table> - dildəki xüsusiyyətlərin hansı brauzer, engine və s. tərəfindən dəstəklənib dəstəklənmədiyini göstərən böyük bir cədvəldir.
 
-To see their support among browser-based and other engines, see:
+Bütün bu resurslar, dil haqqında müəyyən detallar onların nə dərəcədə dəstəklənib dəstəklənmədiyi və s. kimi dəyərli məlumatlarla zəngin olduğu üçün real iş mühitində çox işinizə yaraya bilər.
 
-- <http://caniuse.com> - per-feature tables of support, e.g. to see which engines support modern cryptography functions: <http://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.
+Onları yadda saxlamağınız və detallı məlumat üçün onlara istinad etməyiniz vacibdir.
diff --git a/1-js/01-getting-started/3-code-editors/article.md b/1-js/01-getting-started/3-code-editors/article.md
@@ -1,45 +1,42 @@
-# Code editors
+# Mətn redaktorları
 
-A code editor is the place where programmers spend most of their time.
+Proqramçılar vaxtının çox hissəsini mətn (və ya kod) redaktorları ilə keçirir.
 
-There are two main types of code editors: IDEs and lightweight editors. Many people use one tool of each type.
+Əksər insanlar iki cür mətn redaktorundan istifadə edir: IDE-lər və yüngül redaktorlar.
 
 ## IDE
 
-The term [IDE](https://en.wikipedia.org/wiki/Integrated_development_environment) (Integrated Development Environment) refers to a powerful editor with many features that usually operates on a "whole project." As the name suggests, it's not just an editor, but a full-scale "development environment."
+[IDE](https://en.wikipedia.org/wiki/Integrated_development_environment) (Integrated Development Environment) termini, güclü, çoxlu sayda xüsusiyyətlərə malik olan və bütün proyekt üzərində işləyən redaktorlara istinad edir. Adından da göründüyü kimi, IDE-lər sizin üçün geniş ölçülü development mühiti yaradır.
 
-An IDE loads the project (which can be many files), allows navigation between files, provides autocompletion based on the whole project (not just the open file), and integrates with a version management system (like [git](https://git-scm.com/)), a testing environment, and other "project-level" stuff.
+IDE çoxlu sayda fayldan ibarət olan proyekti yükləyə, fayllar arasında naviqasiya imkanı yarada, kod yazarkən bütün proyekt səviyyəsində avto-tamamlama xüsusiyyəti təklif edə, test mühiti yarada və versiya idarəetmə sistemləri ([git](https://git-scm.com/) kimi) ilə inteqrasiya imkanı yarada bilər.
 
-If you haven't selected an IDE yet, consider the following options:
+Əgər hələ də IDE seçməmisinizsə, aşağıdakılardan birini seçin:
 
-- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free).
-- [WebStorm](http://www.jetbrains.com/webstorm/) (cross-platform, paid).
+- [Visual Studio Code](https://code.visualstudio.com/) (kros-platforma, pulsuz).
+- [WebStorm](http://www.jetbrains.com/webstorm/) (kros-platforma, ödənişlidir lakin təhsil məqsədilə pulsuz istifadə oluna bilər).
 
-For Windows, there's also "Visual Studio", not to be confused with "Visual Studio Code". "Visual Studio" is a paid and mighty Windows-only editor, well-suited for the .NET platform. It's also good at JavaScript. There's also a free version [Visual Studio Community](https://www.visualstudio.com/vs/community/).
+Həmçinin Windows üçün "Visual Studio" ("Visual Studio Code" ilə qarışdırmayın) adlı IDE də mövcuddur. Bu, ödənişli, .NET platforması ilə yaxşı yola gedən, çox güclü və yalnız Windows üzərində işləyən bir IDE-dir. Bu IDE-nin ödənişsiz versiyası da mövcuddur: [Visual Studio Community](https://www.visualstudio.com/vs/community/).
 
-Many IDEs are paid, but have a trial period. Their cost is usually negligible compared to a qualified developer's salary, so just choose the best one for you.
+## Yüngül redaktorlar
 
-## Lightweight editors
+"Yüngül redaktorlar" IDE-lər qədər güclü olmasa da, sadə, sürətli və eleqantdırlar.
 
-"Lightweight editors" are not as powerful as IDEs, but they're fast, elegant and simple.
+Bu cür redaktorlar, əksər hallarda, hər hansı bir faylı tez-bazar açıb redaktə etmək üçün istifadə olunurlar.
 
-They are mainly used to open and edit a file instantly.
+IDE-lər və yüngül redaktorlar arasındakı əsas fərq ondan ibarətdir ki, IDE-lər bütün proyekt üzərində işləyir, analiz aparır və sizin üçün çox rahatlıq yaradır (çox rahatlıq yaxşı deyil :) ) digər təfərdən, "yüngül redaktorlar" sadəcə bir fayl üzərində işləyirsinizsə olduqca sürətlidir və işinizə çox yarayacaq.
 
-The main difference between a "lightweight editor" and an "IDE" is that an IDE works on a project-level, so it loads much more data on start, analyzes the project structure if needed and so on. A lightweight editor is much faster if we need only one file.
+Lakin, bir çox yüngül redaktorlar (Atom, VSCode və s.) çoxlu sayda extension və pluginlər vasitəsilə IDE səviyyəsinə gətirib çıxarıla bilər.
 
-In practice, lightweight editors may have a lot of plugins including directory-level syntax analyzers and autocompleters, so there's no strict border between a lightweight editor and an IDE.
+Yüngül redaktorlara nümunə kimi aşağıdakıları göstərə bilərik:
 
-The following options deserve your attention:
+- [Atom](https://atom.io/) (kros-platforma, pulsuz).
+- [Visual Studio Code](https://code.visualstudio.com/) (kros-platforma, pulsuz və ən sevilən redaktorlardan biri).
+- [Sublime Text](http://www.sublimetext.com) (kros-platforma, əvvəlcə pulsuz sonra ödənişli).
+- [Notepad++](https://notepad-plus-plus.org/) (Windows, pulsuz).
+- [Vim](http://www.vim.org/) və [Emacs](https://www.gnu.org/software/emacs/) isə əgər istifadə edə bilsəniz maraqlı alətlərdir.
 
-- [Atom](https://atom.io/) (cross-platform, free).
-- [Sublime Text](http://www.sublimetext.com) (cross-platform, shareware).
-- [Notepad++](https://notepad-plus-plus.org/) (Windows, free).
-- [Vim](http://www.vim.org/) and [Emacs](https://www.gnu.org/software/emacs/) are also cool if you know how to use them.
+## Gəlin mübahisə etməyək
 
-## Let's not argue
+Bu cür redaktorlar və IDE-lər kimi çoxlu sayda başqaları da var. Sizə qalan isə, özünüzə ən uyğun olanını seçib istifadə etməkdir.
 
-The editors in the lists above are those that either I or my friends whom I consider good developers have been using for a long time and are happy with.
-
-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.
+İşlədiyiniz layihələr, şəxsi öncəlikləriniz və s. şeylər sizi seçiminizə təsir edə bilər.
diff --git a/1-js/01-getting-started/4-devtools/article.md b/1-js/01-getting-started/4-devtools/article.md
@@ -1,64 +1,63 @@
-# Developer console
+# Tərtibatçı alətləri
 
-Code is prone to errors. You will quite likely make errors... Oh, what am I talking about? You are *absolutely* going to make errors, at least if you're a human, not a [robot](https://en.wikipedia.org/wiki/Bender_(Futurama)).
+Yazdığımız kodlar həmişə xatalara meyillidir. Yəni, yəqin ki, arada bir iki səhv edəcəksiniz də... desəm düzgün olmaz, çünki siz **mütləq** səhv edəcəksiniz. Siz insansınız.
 
-But in the browser, users don't see errors by default. So, if something goes wrong in the script, we won't see what's broken and can't fix it.
+Lakin brauzer mühitində istidəçilər həmin xətaları görmürlər. Əgər yazdığınız skriptdə nə isə qaydasında deyilsə, siz onu görə bilməyəcəksiniz və bu səbəbdən də problemi həll etmək sizin üçün çətin olacaq.
 
-To see errors and get a lot of other useful information about scripts, "developer tools" have been embedded in browsers.
+Məhz bu səbəbdən, etdiyimiz xətaları görmək və yazdığımız skriptlər haqqında əlavə məlumat əldə etmək üçün brauzerlər "tərtibatçı alətləri" (developer tools) təqdim edir.
 
-Most developers lean towards Chrome or Firefox for development because those browsers have the best developer tools. Other browsers also provide developer tools, sometimes with special features, but are usually playing "catch-up" to Chrome or Firefox. So most developers have a "favorite" browser and switch to others if a problem is browser-specific.
+Bu cür alətlərin ən yaxşısı və seviləni Chrome və Firefoxda olduğu üçün, əksər proqramçılar məhz bu brauzerləri istifadə edir. Digər brauzerlər də bu kimi tərtibatçı alətləri təqdim etsələr də, Chrome və Firefox ilə demək olar ki, eyni şey olduğu üçün bu iki brauzer əksər proqramçıların sevimlisidir və sadəcə brauzer-spesifik problemlər yarandığı hallarda digər brauzerlərə keçid edirlər.
 
-Developer tools are potent; they have many features. To start, we'll learn how to open them, look at errors, and run JavaScript commands.
+Tərtibatçı alətləri güclüdür və çoxlu sayda xüsusiyyətləri var. Başlanğıc üçün, gəlin onları açmağı, xətalara baxmağı və JavaScript komandalarını icra etməyi öyrənək.
 
 ## Google Chrome
 
-Open the page [bug.html](bug.html).
+[bug.html](bug.html) səhifəsini açın.
 
-There's an error in the JavaScript code on it. It's hidden from a regular visitor's eyes, so let's open developer tools to see it.
+Bu səhifədə yazılmış JavaScript-də xəta var. Bu xəta normal istifadəçidən gizlədilmişdir, gəlin tərtibatçı alətlərini açaq və görək yazılmış kodda nə problem var.
 
-Press `key:F12` or, if you're on Mac, then `key:Cmd+Opt+J`.
+Bunun üçün `key:F12` düyməsini basın. Əgər Mac istifadəçisinizsə o zaman `key:Cmd+Opt+J` kombinasiyasından istifadə edin.
 
-The developer tools will open on the Console tab by default.
+Tərtibatçı alətləri açılacaq və orada çoxlu sayda tab görəcəksiniz. Defolt olaraq isə Console tabı açıq olacaq.
 
-It looks somewhat like this:
+Təxmini belə bir şey:
 
 ![chrome](chrome.png)
 
-The exact look of developer tools depends on your version of Chrome. It changes from time to time but should be similar.
+Konsolun dəqiq görünüşü Chrome-un versiyasına görə dəyişə bilər lakin çox vaxt oxşardır.
 
-- Here we can see the red-colored error message. In this case, the script contains an unknown "lalala" command.
-- On the right, there is a clickable link to the source `bug.html:12` with the line number where the error has occurred.
+- Yəqin ki, konsoldakı qırmızı rəngli xəta mesajını görürsünüz. Bu halda, xəta bizə "lalala" deyə bir şeyin təyin olunmadığını deyir.
+- Sağ tərəfdə isə `bug.html:12` adlı keçid var. Bu keçid, bizə xətanın `bug.html` faylının `12`-ci sətrindən qaynaqlandığını göstərir.
 
-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 (`key:Shift+Enter` to input multi-line commands).
+Ondan aşağıda gördüyünüz `>` işarəsi isə komanda xəttidir (command line) . Siz burada JavaScript komandaları yaza və `key:Enter` basmaqla həmin komandaları icra edə bilərsiniz.
 
-Now we can see errors, and that's enough for a start. We'll come back to developer tools later and cover debugging more in-depth in the chapter <info:debugging-chrome>.
+Artıq xətaları görə bildiyimizə görə hələ ki, bu bizim üçün kifayətdir. Sonrakı fəsillərdə debugging (bug-lardan təmizləmə) haqqında daha çox öyrənəcəyik.
 
+```smart header="Bir neçə sətirlik komandalar"
+Adətən komandanı daxil edib `key:Enter` basdıqdan sonra həmin komanda icra olunur.
 
-## Firefox, Edge, and others
+Əgər bir neçə sətirlik kod yazırsınızsa, o zaman `key:Shift+Enter` basın. Bu vasitə ilə siz uzun JavaScript kodları yaza və icra edə bilərsiniz.
+```
+
+## Firefox, Edge və başqaları
 
-Most other browsers use `key:F12` to open developer tools.
+Əksər brauzerlərdə alətləri açmaq üçün `key:F12` komandasından istifadə olunur.
 
-The look & feel of them is quite similar. Once you know how to use one of these tools (you can start with Chrome), you can easily switch to another.
+Görünüş hamısında demək olar ki, eynidir. Birini istifadə etməyi tam öyrəndikdən sonra (misalçün Chrome ilə başlaya bilərsiniz) digərlərinə rahatlıqla keçid edə bilərsiniz.
 
 ## Safari
 
-Safari (Mac browser, not supported by Windows/Linux) is a little bit special here. We need to enable the "Develop menu" first.
+Safaridə (Mac brauzerdiri, Windows/Linux əməliyyat sistemlərində dəstəklənmir) isə vəziyyət bir qədər fərqlidir. Əvvəlcə "Develop menu"-nu aktiv etməyimiz lazımdır.
 
-Open Preferences and go to the "Advanced" pane. There's a checkbox at the bottom:
+Bunun üçün öncəliklər (Preferences) pəncərəsini açın və "Advanced" panelinə daxil olun. Orada aşağıdakı kimi bir checkbox görəcəksiniz:
 
 ![safari](safari.png)
 
-Now `key:Cmd+Opt+C` can toggle the console. Also, note that the new top menu item named "Develop" has appeared. It has many commands and options.
-
-```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.
-```
+İndi isə `key:Cmd+Opt+C` kombinasiyası ilə konsolu aça və bağlaya bilərsiniz. Nəzərinizə çatdıraq ki, yuxarı menyuda da "Develop" adlı yeni bir seçim yaranmışdır.
 
-## Summary
+## Xülasə
 
-- 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).
+- Tərtibatçı alətləri bizə xətaları görmək, komandalar icra etmək, dəyişənləri təhlil etmək və s. bu kimi çoxlu sayda imkanlar yaradır.
+- `key:F12` komandası ilə onları aça və istifadə edə bilərsiniz. Chrome for Mac üçün `key:Cmd+Opt+J`, Safari üçün isə `key:Cmd+Opt+C` kombinasiyalarında istifadə edin (unutmayın ki, Safaridə əvvəlcə bunu aktivləşdirmək lazmdır).
 
-Now we have the environment ready. In the next section, we'll get down to JavaScript.
+Mühit ilə bağlı hər şeyi yekunlaşdırdığımız üçün artıq JavaScript ilə yaxından tanış olmağa tam hazırıq.