merging all conflicts

Author: iliakan

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

@@ -46,13 +46,23 @@
 
 بخاطر سپردن این نام‌ها مفید هستند، چراکه در مقالات مختلف به آنها بر خواهید خورد، همینطور زمانیکه ما در این آموزش برای نمونه می‌گوییم ویژگی X توسط موتور **V8** پشتیبانی می‌شود، یعنی به احتمال زیاد در مرورگرهای کروم و اپرا پشتیبانی خواهد شد.  
 
+<<<<<<< HEAD
 
+=======
+1. The engine (embedded if it's a browser) reads ("parses") the script.
+2. Then it converts ("compiles") the script to machine code.
+3. And then the machine code runs, pretty fast.
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 **موتورها** **چگونه کار** **می‌کنند** 
 
 موتورها پیچیده هستند، ولی اساس آنها ساده است.  
 
+<<<<<<< HEAD
 ۱. موتور در ابتدا اِسکریپت را می‌خواند (Parse).  
+=======
+Modern JavaScript is a "safe" programming language. It does not provide low-level access to memory or the CPU, because it was initially created for browsers which do not require it.
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 ۲. سپس آن را به زبان ماشین ترجمه می‌کند (Compile). 
 
@@ -64,23 +74,41 @@
 
 
 
+<<<<<<< HEAD
 ## جاوا اِسکریپت در مرورگر چه توانایی‌هایی دارد  ؟   
+=======
+JavaScript's abilities in the browser are limited to protect the user's safety. The aim is to prevent an evil webpage from accessing private information or harming the user's data.
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 
 
 جاوا اِسکریپت مدرن زبانی‌ست امن. این زبان اجازه دسترسی در سطوح پایین مانند درسترسی به حافظه (Memory) و پردازنده (CPU) را نمی‌دهد، چراکه از ابتدا برای مرورگرها (که نیازی به این موراد ندارند) ساخته شده بود.  
 
 
 
+<<<<<<< HEAD
 قابلیت‌های جاوا اِسکریپت کاملا به محیطی که در آن اجرا می‌شود بستگی دارد. برای نمونه با جاوا اِسکریپت در [Node.JS](https://wikipedia.org/wiki/Node.js) می‌توان عملیات خواندن و نوشتن (Read/Write) روی فایل‌ها را انجام داد، و یا در شبکه درخواست‌هایی ارسال و دریافت کرد، و دیگر موارد.  
 
 
 
 در مرورگر جاوا اِسکریپت می‌تواند تمامی تعمالات لازم با کاربر و وب‌سِرور را انجام دهد.  
+=======
+    There are ways to interact with the camera/microphone and other devices, but they require a user's explicit permission. So a JavaScript-enabled page may not sneakily enable a web-camera, observe the surroundings and send the information to the [NSA](https://en.wikipedia.org/wiki/National_Security_Agency).
+- Different tabs/windows generally do not know about each other. Sometimes they do, for example when one window uses JavaScript to open the other one. But even in this case, JavaScript from one page may not access the other page if they come from different sites (from a different domain, protocol or port).
+
+    This is called the "Same Origin Policy". To work around that, *both pages* must agree for data exchange and must contain special JavaScript code that handles it. We'll cover that in the tutorial.
+
+    This limitation is, again, for the user's safety. A page from `http://anysite.com` which a user has opened must not be able to access another browser tab with the URL `http://gmail.com`, for example, and steal information from there.
+- JavaScript can easily communicate over the net to the server where the current page came from. But its ability to receive data from other sites/domains is crippled. Though possible, it requires explicit agreement (expressed in HTTP headers) from the remote side. Once again, that's a safety limitation.
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 
 
+<<<<<<< HEAD
 برای نمونه جاوا اِسکریپت در مرورگر می‌تواند :  
+=======
+Such limitations do not exist if JavaScript is used outside of the browser, for example on a server. Modern browsers also allow plugins/extensions which may ask for extended permissions.
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 
 
@@ -154,15 +182,23 @@
 
 ##  زبان‌هایی فراتر از جاوا اِسکریپت  
 
+<<<<<<< HEAD
 
+=======
+That said, JavaScript can be used to create servers, mobile applications, etc.
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 سینتَکس (Syntax) جاوا اِسکریپت مورد نیاز هر کسی نیست و اشخاص مختلف به قابلیت‌های متفاوتی نیاز دارند. چراکه نیازمندی‌های هر پروژه متفاوت است.  
 
 
 
 اخیرا تعداد زیادی زبان بوجود آمده‌اند که به جاوا اِسکریپت تبدیل (Transpile) شده، پیش از آنکه جاوا اِسکریپت در مرورگر اجرا شود.  
 
+<<<<<<< HEAD
 
+=======
+So, recently a plethora of new languages appeared, which are *transpiled* (converted) to JavaScript before they run in the browser.
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 نمونه‌هایی از این زبان‌ها : 
 
@@ -172,6 +208,7 @@
 - [Dart](https://www.dartlang.org/) : که زبانی مستقل با موتور مربوط به خود بوده و در محیط‌های غیر مرورگری (مانند نرم‌افزارهای موبایل) کار می‌کند. این زبان در ابتدا توسط گوگل معرفی شد تا جایگزینی برای جاوا اِسکریپت باشد.  
 - [Brython](https://brython.info/) یک ترانسپایلر پایتون به جاوا اسکریپت است که توسعه دهندگان را قادر می سازد برنامه هایی به زبان پایتون خالص بدون جاوا اسکریپت بنویسند.
 
+<<<<<<< HEAD
 ## خلاصه 
 
 - [CoffeeScript](https://coffeescript.org/) یک «syntactic sugar(سینتکس راحت‌تر)» برای جاوااسکریپت است. این زبان سینتکس کوتاه‌تری را معرفی می‌کند که به ما اجازه نوشتن کدی تمیزتر و دقیق‌تر را می‌دهد. معمولا،  توسعه‌دهندگان زبان Ruby آن را دوست دارند.
@@ -180,6 +217,16 @@
 - [Dart](https://www.dartlang.org/) یک زبان مستقل است که موتور خود را دارد که در محیط‌های غیر مرورگر اجرا می‌شود (مانند اپ‌های موبایل) اما می‌تواند به جاوااسکریپت هم ترجمه شود. توسط گوگل توسعه داده شده است.
 - [Brython](https://brython.info/) یک مترجم پایتون به جاوااسکریپت است که نوشتن یک برنامه به طور کامل در زبان پایتون را بدون جاوااسکریپت مقدور می‌سازد.
 - [Kotlin](https://kotlinlang.org/docs/reference/js-overview.html) یک زبان برنامه‌نویسی مدرن، مختصر و امن است که می‌تواند مرورگر یا Node را مورد هدف قرار دهد.
+=======
+- [CoffeeScript](https://coffeescript.org/) is "syntactic sugar" for JavaScript. It introduces shorter syntax, allowing us to write clearer and more precise code. Usually, Ruby devs like it.
+- [TypeScript](https://www.typescriptlang.org/) is concentrated on adding "strict data typing" to simplify the development and support of complex systems. It is developed by Microsoft.
+- [Flow](https://flow.org/) also adds data typing, but in a different way. Developed by Facebook.
+- [Dart](https://www.dartlang.org/) is a standalone language that has its own engine that runs in non-browser environments (like mobile apps), but also can be transpiled to JavaScript. Developed by Google.
+- [Brython](https://brython.info/) is a Python transpiler to JavaScript that enables the writing of applications in pure Python without JavaScript.
+- [Kotlin](https://kotlinlang.org/docs/reference/js-overview.html) is a modern, concise and safe programming language that can target the browser or Node.
+
+There are more. Of course, even if we use one of these transpiled languages, we should also know JavaScript to really understand what we're doing.
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 - جاوا اِسکریپت در ابتدا برای مرورگرها ساخته شده بود ولی در حال حاضر در محیط‌های متفاوتی قابلیت اجرا دارد.  
 - جاوا اِسکریپت در شرایط حاضر موقعیت مشخص و منحصر بفردی در زبان‌های تحت مرورگرها دارد که تطابق کاملی با HTML و CSS را دارا می‌باشد.  

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

@@ -72,7 +72,11 @@ alert(age); // NaN, conversion failed
 |`undefined`|`NaN`|
 |`null`|`0`|
 |<code>true&nbsp;and&nbsp;false</code> | `1` and `0` |
+<<<<<<< HEAD
 | `string` | فاصله‌های خالی ابتدا و انتها حذف می‌شوند. اگر رشته‌ی باقی مانده خالی باشد نتیجه `0` خواهد بود. در غیر اینصورت عدد موجود در رشته کاراکترها خوانده خواهد شد. همینطور اگر خطایی رخ دهد نتیجه `NaN` خواهد بود. |
+=======
+| `string` | Whitespaces (includes spaces, tabs `\t`, newlines `\n` etc.) from the start and end are removed. If the remaining string is empty, the result is `0`. Otherwise, the number is "read" from the string. An error gives `NaN`. |
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 Examples:
 
@@ -146,9 +150,13 @@ alert( Boolean(" ") ); // spaces, also true (any non-empty string is true)
 |`undefined`|`NaN`|
 |`null`|`0`|
 |<code>true&nbsp;/&nbsp;false</code> | `1 / 0` |
+<<<<<<< HEAD
 | `string` | فاصله‌های خالی ابتدا و انتها حذف می‌شوند. اگر رشته‌ی باقی مانده خالی باشد نتیجه `0` خواهد بود. در غیر اینصورت عدد موجود در رشته کاراکترها خوانده خواهد شد. همینطور اگر خطایی رخ دهد نتیجه `NaN` خواهد بود. |
 
 **`تبدیل به boolean`** – در عملگرهای  منطقی رخ می‌دهد. از طریق `Boolean(value)` قابل انجام است.
+=======
+| `string` | The string is read "as is", whitespaces (includes spaces, tabs `\t`, newlines `\n` etc.) from both sides are ignored. An empty string becomes `0`. An error gives `NaN`. |
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 این تبدیل از این قوانین پیروی می‌کند :
 

1-js/02-first-steps/08-operators/article.md

@@ -194,18 +194,32 @@ alert( +apples + +oranges ); // 5
 | اولویت | نام | علامت |
 |------------|------|------|
 | ... | ... | ... |
+<<<<<<< HEAD
 | 15 | جمع یگانه | `+` |
 | 15 | تفریق یگانه | `-` |
 | 14 | بتوان رساندن | `**` |
 | 13 | ضرب | `*` |
 | 13 | تقسیم | `/` |
 | 12 | جمع | `+` |
 | 12 | تفریق | `-` |
+=======
+| 14 | unary plus | `+` |
+| 14 | unary negation | `-` |
+| 13 | exponentiation | `**` |
+| 12 | multiplication | `*` |
+| 12 | division | `/` |
+| 11 | addition | `+` |
+| 11 | subtraction | `-` |
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 | ... | ... | ... |
 | 2 | مقداردهی | `=` |
 | ... | ... | ... |
 
+<<<<<<< HEAD
 همانطور که می‌بینیم «عملگر + یگانه» اولویت `15` دارد که از عملگر جمع ( + دوگانه) با اولویت `12` بالاتر است. به همین دلیل است که در عبارت `"+apples + +oranges"` عملگرهای + یگانه پیش از علامت جمع اجرا می‌شوند.
+=======
+As we can see, the "unary plus" has a priority of `14` which is higher than the `11` of "addition" (binary plus). That's why, in the expression `"+apples + +oranges"`, unary pluses work before the addition.
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 ## مقداردهی
 
@@ -303,9 +317,13 @@ alert( n ); // 14
 ```js run
 let n = 2;
 
-n *= 3 + 5;
+n *= 3 + 5; // right part evaluated first, same as n *= 8
 
+<<<<<<< HEAD
 alert( n ); // 16 (یکسان است n *= 8، قسمت سمت راست اول ارزیابی می‌شود)
+=======
+alert( n ); // 16  
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 ```
 
 ## عملگر افزایش/کاهش 

1-js/02-first-steps/12-nullish-coalescing-operator/article.md

@@ -106,7 +106,11 @@ alert(height ?? 100); // 0
 
 ## اولویت
 
+<<<<<<< HEAD
 اولویت عملگر `??` برابر با عملگر `||` است. اولویت آن‌ها در [جدول MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence#Table) برابر با `4` است.
+=======
+The precedence of the `??` operator is the same as `||`. They both equal `3` in the [MDN table](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence#Table).
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 این یعنی که درست مانند `||`، عملگر nullish coalescing `??` قبل از `=` و `?` ارزیابی می‌شود، اما بعد از بیشتر عملیات‌ها مانند `+`، `-` ارزیابی می‌شود.
 

1-js/02-first-steps/15-function-basics/article.md

@@ -24,7 +24,7 @@ function showMessage() {
 
 ```js
 function name(parameter1, parameter2, ... parameterN) {
-  ...body...
+ // body
 }
 ```
 
@@ -206,7 +206,17 @@ function showMessage(from, *!*text = "no text given"*/!*) {
 showMessage("Ann"); // Ann: no text given
 ```
 
+<<<<<<< HEAD
 حالا اگر پارامتر `text` پاس داده نشود، مقدار `"no text given"` را می‌گیرد.
+=======
+Now if the `text` parameter is not passed, it will get the value `"no text given"`.
+
+The default value also jumps in if the parameter exists, but strictly equals `undefined`, like this:
+
+```js
+showMessage("Ann", undefined); // Ann: no text given
+```
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 اینجا `"no text given"` یک رشته است، اما می‌تواند عبارت پیچیده‌تری باشد، که تنها در حالتی ارزیابی و مقداردهی می‌شود که پارامتری وجود نداشته باشد. بنابراین این هم ممکن است:
 

1-js/03-code-quality/05-testing-mocha/article.md

@@ -79,7 +79,7 @@ So, the development is *iterative*. We write the spec, implement it, make sure t
 
 Let's see this development flow in our practical case.
 
-The first step is already complete: we have an initial spec for `pow`. Now, before making the implementation, let's use few JavaScript libraries to run the tests, just to see that they are working (they will all fail).
+The first step is already complete: we have an initial spec for `pow`. Now, before making the implementation, let's use a few JavaScript libraries to run the tests, just to see that they are working (they will all fail).
 
 ## The spec in action
 

1-js/04-object-basics/09-object-toprimitive/article.md

@@ -137,8 +137,13 @@ alert(user + 500); // hint: default -> 1500
 
 اگر `Symbol.toPrimitive` وجود نداشته باشد، سپس جاوااسکریپت سعی می‌کند که متدهای `toString` و `valueOf`  را پیدا کند:
 
+<<<<<<< HEAD
 - برای جزء "string": `toString` و اگر این متد وجود نداشت، سپس `valueOf` (پس `toString` برای تبدیل‌های رشته‌ای اولویت دارد).
 - برای بقیه جزءها: `valueOf` و اگر این متد وجود نداشت، سپس `toString` (پس `valueOf` برای ریاضیات اولویت دارد).
+=======
+- For the `"string"` hint: call `toString` method, and if it doesn't exist or if it returns an object instead of a primitive value, then call `valueOf` (so `toString` has the priority for string conversions).
+- For other hints: call `valueOf`, and if it doesn't exist or if it returns an object instead of a primitive value, then call `toString` (so `valueOf` has the priority for maths).
+>>>>>>> 1edb0a38330b54d2e1916f5193fc043e6fbbea78
 
 متدهای `toString` و `valueOf` از زمان‌های گذشته وجود دارند. آن‌ها سمبل نیستند (سمبل‌ها انقدر قدیمی نیستند) بلکه متدهای «معمولی» هستند که اسمی رشته‌ای دارد. آن‌ها راهی جایگزین برای پیاده‌سازی تبدیل به «سبک قدیمی» را  فراهم می‌کنند.