Translated chapter Getting Started

Author: tmollov

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

@@ -1,42 +1,41 @@
 
-# Manuals and specifications
+# Ръководства и спецификации
 
-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.
+Тази книга е "ръководство". То цели да ви помогне постепенно да научите езика. Но когато научите основите ще ви са необходими и други ресурси.
 
-## Specification
+## Спецификации
 
-[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.
+[Спецификаците на ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) съдържа най-задълбочените, изчерпателни и оформени информации относно езика JavaScript. То определя езика.
 
-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.
+Но толкова оформенна документация е трудна за разбиране. Ако ви е нужна най-сигурния ресурс на информация относно детайлите на езика, спецификациите са на важа помощ. Но не са за ежедневна употреба.
 
-A new specification version is released every year. In-between these releases, the latest specification draft is at <https://tc39.es/ecma262/>.
+Нови спецификации са публикувани всяка година. Между тях, последния публикуван е <https://tc39.es/ecma262/>
 
-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>.
+За да прочетете за новите функции, включително тези, които са "почти стандартни" (т. Нар. "Етап 3"), посетете <https://github.com/tc39/proposals>.
 
-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.
+Също така, ако разработвате за браузъра, има и други спецификации покрити в [втората част](info:browser-environment) на ръководството.
 
-## Manuals
+## Ръководства
 
-- **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.
+- **MDN (Mozilla) JavaScript Reference** е ръководство с примери и информация. Чудесен е за да навлизате по-задълбочено в собствените функции на езика.
 
-    One can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
+    Можете да ги намерите в следния линк <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 `parseInt` function.
+    Макар че, много често, най-добрия начин е да се използва търсачката в интернет. Просто напишете "MDN [термина]" когато попълвате търсачката, например ето така "MDN parseInt" за да търсите функцията `parseInt` в MDN.
 
+- **MSDN** – Ръководството на Microsoft с много информация, включително и за JavaScript (много често рефериран катo JScript). Ако се нуждаеш от нещо специфично, по-добре е да посетите линка: <http://msdn.microsoft.com/>.
 
-- **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/>.
+    Също така, можете да използвате фразите, например "RegExp MSDN" или "RegExp MSDN jscript", когато търсите из интернет.
 
-    Also, we can use an internet search with phrases such as "RegExp MSDN" or "RegExp MSDN jscript".
+## Таблици за съвместимост
 
-## Compatibility tables
+JavaScript e развиващ език, редовно се добавят нови функции и подобрения.
 
-JavaScript is a developing language, new features get added regularly.
+За да видите поддръжката на браузърите и двигателите, вижте:
 
-To see their support among browser-based and other engines, see:
+- <http://caniuse.com> - таблици за поддръжката на функциите, или за да видите кои двигатели поддържат модерните криптографски функции: <http://caniuse.com/#feat=cryptography>.
+- <https://kangax.github.io/compat-table> - таблица с функциите на езика и двигателите, които ги поддържат или не ги поддържат.
 
-- <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.
+Запомнете тези страници (или тази страница) в случай че може и да ви потрябва информация за определени особености.

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

@@ -1,46 +1,46 @@
-# Code editors
+# Редактори на код
 
-A code editor is the place where programmers spend most of their time.
+Редакторите на код е мястото, където програмистите прекарват по-голямата част от времето си.
 
-There are two main types of code editors: IDEs and lightweight editors. Many people use one tool of each type.
+Има два главни типа редактори: IDE (т. нар. *Integrated development environment* - Интегрирана среда за разработка) и леки редактори. Много хора използват по един инструмент от всеки тип.
 
-## IDE
+## 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) (Интегрирана Среда за Разработка) е много мощен редактор с много функции, който попринцип управлява "целия проект". Както от името разбрахте, то не е само редактор, а пълномащабна **"среда за разработка"**.
 
-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.
+Интегрираната среда за разработка зарежда целия проект (което може да съдържа много файлове), позволява навигирането между файловете, осигурява автоматично довършване в зависимост от целия проект (не само от отворения файл), интегрира се със сисмети за управление на версиите (като [git](https://git-scm.com/)), включва среда за тестване и много други функции свързвани с проекта.
 
-If you haven't selected an IDE yet, consider the following options:
+Ако още не сте избрали интегрирана среда за разработка, обмислете следните опции:
 
-- [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/) (междуплатформена, безплатен).
+- [WebStorm](http://www.jetbrains.com/webstorm/) (междуплатформена, платен).
 
-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/).
+За ОС Windows, съществува също и **"Visual Studio"**, но не го объркайте с *"Visual Studio Code"*. **"Visual Studio"** е платен и мощен редактор само във ОС Windows, незаменим за .NET платформата. Също е добър за писане на JavaScript. Същестува и безплатна версия на *"Visual Studio"* наречена *[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.
+Повечето среди за разработка са платени, но имат пробен период. Цената им попринцип е незначителна, ако ги сравним с доходите на разработчиците, така че изберете най-добрия за вас.
 
-## Lightweight editors
+## Леки редактори
 
-"Lightweight editors" are not as powerful as IDEs, but they're fast, elegant and simple.
+"Леките редактори" не са силни колкото средите за разработка, но са много бързи, елеганти и прости.
 
-They are mainly used to open and edit a file instantly.
+Използвани са предимно да отварят и редактират файла на момента.
 
-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.
+Главната разлика между "леките редактори" и средите за разработка е това че средите за разработка работят на нивото на проекта, като зареждат много повече данни при пускането си, анализират структурата на проекта ако е необходимо и т.н. Леките редактори са много по-бързи, ако отворите само един файл.
 
-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.
+Напрактика, леките редактори имат много повече добавки включващи анализатор на синтаксиса на ниво директория и автоматично довършване, така че няма строга граница между леките редактори и средите за разработка.
 
-The following options deserve your attention:
+Следните опции заслужават вниманието ви:
 
-- [Atom](https://atom.io/) (cross-platform, free).
-- [Visual Studio Code](https://code.visualstudio.com/) (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.
+- [Atom](https://atom.io/) (междуплатформена, безплатен).
+- [Visual Studio Code](https://code.visualstudio.com/) (междуплатформена, безплатен).
+- [Sublime Text](http://www.sublimetext.com) (междуплатформена, споделен).
+- [Notepad++](https://notepad-plus-plus.org/) (OS Windows, безплатен).
+- [Vim](http://www.vim.org/) и [Emacs](https://www.gnu.org/software/emacs/) също са яки, ако знаете как да ги използвате
 
-## Let's not argue
+## Нека да не спорим
 
-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.
+Изборът на редактор, също като другите инструменти, е индивидуално и зависи от проектите, навиците и персоналните предпочитания.