Fix a part of conflicts

Author: mahdiHash

1-js/02-first-steps/16-function-expressions/article.md

@@ -144,21 +144,13 @@ function showCancel() {
 ask("آیا موافق هستید؟", showOk, showCancel);
 ```
 
-<<<<<<< HEAD
-در عمل، چنین تابع هایی بسیار مفید هستند. تفاوت اصلی بین یک `ask` در زندگی واقعی و مثال بالا در این است که تابع‌ها در زندگی واقعی از راه‌های پیچیده‌تری نسبت به یک `confirm` ساده برای تعامل با کاربر استفاده استفاده می کنند. در مرورگر، چنین تابع‌هایی معمولا یک پنچره سوال زیبا را طرح می‌کنند. اما آن یک داستان دیگر است.
-=======
-In practice, such functions are quite useful. The major difference between a real-life `ask` and the example above is that real-life functions use more complex ways to interact with the user than a simple `confirm`. In the browser, such functions usually draw a nice-looking question window. But that's another story.
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
+در عمل، چنین تابع هایی بسیار مفید هستند. تفاوت اصلی بین یک `ask` در زندگی واقعی و مثال بالا در این است که تابع‌ها در زندگی واقعی از راه‌های پیچیده‌تری نسبت به یک `confirm` ساده برای تعامل با کاربر استفاده می‌کنند. در مرورگر، چنین تابع‌هایی معمولا یک پنچره پرسش زیبا را ایجاد می‌کنند. اما آن یک داستان دیگر است.
 
 **آرگومان‌های `showOk` و `showCancel` داخل `ask` *callback functions* یا فقط *callbacks* نامیده می‌شوند.**
 
 ایده اینطور است که ما یک تابع را می‌دهیم و از آن توقع داریم که بعدا اگر نیاز شد "دوباره صدا زده شود". در مورد ما، `showOk` تبدیل به callback برای جواب "yes" می‌شود، و `showCancel` برای چواب "no".
 
-<<<<<<< HEAD
-ما می توانیم از Function Expressions برای نوشتن بسیار کوتاه‌تر همان تابع استفاده کنیم:
-=======
-We can use Function Expressions to write an equivalent, shorter function:
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
+ما می توانیم از Function Expressions برای نوشتن همان تابع به صورت بسیار کوتاه‌تر استفاده کنیم:
 
 ```js run no-beautify
 function ask(question, yes, no) {
@@ -194,23 +186,15 @@ ask(
 
 اول، سینتکس: چگونه داخل کد بین آنها فرق قائل شویم.
 
-<<<<<<< HEAD
-- *Function Declaration:* یک تابع است، که به عنوان یک دستور جدا، در کد اصلی تعریف می‎شود.
-=======
-- *Function Declaration:* a function, declared as a separate statement, in the main code flow:
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
+- *Function Declaration:* یک تابع است، که به عنوان یک دستور جدا، در کد اصلی تعریف می‌شود.
 
     ```js
     // Function Declaration
     function sum(a, b) {
       return a + b;
     }
     ```
-<<<<<<< HEAD
 - *Function Expression:* یک تابع است، که در داخل یک عبارت یا داخل یک ساختار سینتکس دیگر ساخته می‌شود. اینجا، تابع سمت راست "عبارت تخصیص دادن" `=` ساخته شده است.
-=======
-- *Function Expression:* a function, created inside an expression or inside another syntax construct. Here, the function is created on the right side of the "assignment expression" `=`:
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
 
     ```js
     // Function Expression
@@ -307,29 +291,18 @@ if (age < 18) {
   welcome();               // \   (اجرا می‌شود)
 */!*
                            //  |
-<<<<<<< HEAD
   function welcome() {     //  |  
     alert("سلام!");         //  |  Function Declaration در دسترس است
   }                        //  |  هرجایی از بلوکی که داخل آن تعریف شده است
-=======
-  function welcome() {     //  |
-    alert("Hello!");       //  |  Function Declaration is available
-  }                        //  |  everywhere in the block where it's declared
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
                            //  |
 *!*
   welcome();               // /   (اجرا می‌شود)
 */!*
 
 } else {
 
-<<<<<<< HEAD
   function welcome() {    
     alert("درود!");
-=======
-  function welcome() {
-    alert("Greetings!");
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
   }
 }
 
@@ -386,13 +359,8 @@ welcome(); // الان درست است
 ```
 
 
-<<<<<<< HEAD
 ```smart header="چه زمانی Function Declaration را انتخاب کنیم و چه زمانی Function Expression؟"
 به عنوان یک قاعده کلی، زمانی که ما نیاز به تعریف یک تابع داریم، اولین چیزی که باید سراغ آن برویم سینتکس Function Declaration است. آن به ما آزادی بیشتری برای سازماندهی کردن کد مان به ما می‌دهد، چون ما می‌توانیم چنین تابع‌هایی را قبل از اینکه تعریف شوند صدا بزنیم.
-=======
-```smart header="When to choose Function Declaration versus Function Expression?"
-As a rule of thumb, when we need to declare a function, the first thing to consider is Function Declaration syntax. It gives more freedom in how to organize our code, because we can call such functions before they are declared.
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
 
 همچنین آن برای خوانایی نیز بهتر است، چون پیدا کردن `function f(...) {...}` در کد راحت تر است از `let f = function(...) {...}`. Function Declarationها "چشم نوازتر" هستند.
 

1-js/02-first-steps/17-arrow-functions-basics/article.md

@@ -63,13 +63,9 @@ alert(sum(1, 2)); // 3
 ```js run
 let age = prompt("What is your age?", 18);
 
-<<<<<<< HEAD
-let welcome = age < 18 ? () => alert("Hello") : () => alert("Greetings!");
-=======
 let welcome = (age < 18) ?
   () => alert('Hello!') :
   () => alert("Greetings!");
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
 
 welcome();
 ```

1-js/02-first-steps/18-javascript-specials/article.md

@@ -55,11 +55,7 @@ for(;;) {
 
 این دستور می‌تواند در ابتدای یک فایل جاوااسکریپت یا ابتدای یک تابع نوشته شود.
 
-<<<<<<< HEAD
 بدون نوشتن `"use strict"` هم کد ما کار می‌کند، ولی بعضی چیزها در حالت قدیمی خود عمل می‌کنند. ما معمولاً رفتار مدرن آن‌ها را ترجیح می‌دهیم.
-=======
-Without `"use strict"`, everything still works, but some features behave in the old-fashioned, "compatible" way. We'd generally prefer the modern behavior.
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
 
 بعضی از ویژگی‌های مدرن جاوااسکریپت (مثل کلاس‌ها که بعداً به آن می‌رسیم) به صورت خودکار و بدون اینکه نیازی باشد `"use strict"` را بنویسیم کد را در حالت strict اجرا می‌کنند.
 
@@ -147,13 +143,8 @@ alert( "Tea wanted: " + isTeaWanted ); // true
 مقداردهی (Assignments)
 : دو نوع مقداردهی داریم: مقداردهی معمولی مثل `a = b` و مقداردهی ترکیبی مثل `a *= 2`.
 
-<<<<<<< HEAD
 بیتی (Bitwise)
 : عملگرهای بیتی با اعداد 32 بیتی در پایین‌ترین سطح یعنی بیت کار می‌کنند: زمانی که به آنها نیاز داشتید به [مستندات](mdn:/JavaScript/Guide/Expressions_and_Operators#Bitwise) مراجعه کنید.
-=======
-Bitwise
-: Bitwise operators work with 32-bit integers at the lowest, bit-level: see the [docs](mdn:/JavaScript/Guide/Expressions_and_Operators#bitwise_operators) when they are needed.
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
 
 شرطی (Conditional)
 : تنها اپراتور 3 پارامتری: `cond ? resultA : resultB`. اگر `cond` truthy باشد، `resultA` را برمی‌گرداند، در غیر این صورت `resultB`.
@@ -265,11 +256,7 @@ switch (age) {
 3. تابع پیکانی (Arrow Function)
 
     ```js
-<<<<<<< HEAD
-    // :عبارت سمت راست برمی‌گردد
-=======
-    // expression on the right side
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
+    // عبارت سمت راست
     let sum = (a, b) => a + b;
 
     // یا مدل چند خطی با {...}، که در این حالت باید return :هم بنویسید

1-js/03-code-quality/03-comments/article.md

@@ -138,25 +138,22 @@ function pow(x, n) {
 }
 ```
 
-<<<<<<< HEAD
 چنین یادداشت هایی به ما امکان می دهد بدون نگاه کردن به کد  ، هدف از تابع را بفهمیم و از آن به روش صحیح استفاده کنیم.
-=======
-Such comments allow us to understand the purpose of the function and use it the right way without looking in its code.
 
-By the way, many editors like [WebStorm](https://www.jetbrains.com/webstorm/) can understand them as well and use them to provide autocomplete and some automatic code-checking.
+راستی، بسیاری از ویراستارها مانند [WebStorm](https://www.jetbrains.com/webstorm/) می‌توانند آن‌ها را متوجه شوند و از آن‌ها برای فراهم کردن تکمیل خودکار و بعضی بررسی خودکار کدهای استفاده کنند.
 
-Also, there are tools like [JSDoc 3](https://github.com/jsdoc/jsdoc) that can generate HTML-documentation from the comments. You can read more information about JSDoc at <https://jsdoc.app>.
+همچنین، ابزارهایی مانند [JSDoc 3](https://github.com/jsdoc/jsdoc) وجود دارند که می‌توانند از یادداشت‌ها مستنداتی در غالب HTML تولید کنند. شما می‌توانید درباره JSDoc در <https://jsdoc.app> بیشتر اطلاعات کسب کنید.
 
-Why is the task solved this way?
-: What's written is important. But what's *not* written may be even more important to understand what's going on. Why is the task solved exactly this way? The code gives no answer.
 
-    If there are many ways to solve the task, why this one? Especially when it's not the most obvious one.
+چرا تمرین اینگونه حل شد؟
+: چیزی که نوشته شده است مهم است. اما برای فهمیدن اینکه چه چیزی در حال رخ دادن است شاید چیزی که نوشته *نشده* است مهمتر باشد. چرا این تمرین دقیقا به این روش حل شد؟ قطعه کد جوابی نمی‌دهد.
 
-    Without such comments the following situation is possible:
-    1. You (or your colleague) open the code written some time ago, and see that it's "suboptimal".
-    2. You think: "How stupid I was then, and how much smarter I'm now", and rewrite using the "more obvious and correct" variant.
-    3. ...The urge to rewrite was good. But in the process you see that the "more obvious" solution is actually lacking. You even dimly remember why, because you already tried it long ago. You revert to the correct variant, but the time was wasted.
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
+    اگر راه‌های زیادی برای حل این تمرین وجود دارد، چرا این یکی؟ خصوصا وقتی این راه‌حل واضح‌ترین آن‌ها نیست.
+
+    بدون چنین یادداشت‌هایی موقعیت زیر احتمال رخداد دارد:
+    1. شما (یا همکار شما) کدی که چند وقت پیش نوشته شده است را باز می‌کنید و می‌بینید که این کد «زیرمجموعه« است.
+    2. شما اینطور فکر می‌کنید: «چقدر آن زمان احمق وبدم و چقدر الان باهوش‌تر هستم» و کد با به روش «واضح‌تر و درست‌تر» بازنویسی می‌کنید.
+    3. ...اصرار به بازنویسی خوب بود. اما در حین پروسه می‌بینید که روش «واضح‌تر» در واقع کمبود دارد. شما به سختی دلیل آن را به یاد می‌آورید چون خیلی وقت پیش آن را امتحان کردید. شما برمی‌گردید که این نوع کد نوشته شده را اصلاح کنید اما زمان هدر رفته.
 
  به هر حال ، بسیاری از ویراستاران مانند 
  [WebStorm](https://www.jetbrains.com/webstorm/)

1-js/03-code-quality/06-polyfills/article.md

@@ -5,11 +5,7 @@
 
 تیم‌های مسئول موتورهای جاوااسکریپت تصمیم می‌گیرند کدام یک را اول پیاده‌سازی کنند. ممکن است تصمیم بگیرند پیشنهادهایی که هنوز به‌صورت پیش‌نویس هستند را اول پیاده‌سازی کنند و پیشنهادهایی که در مرحلهٔ تشخیص هستند را به بعدتر موکول کنند، به دلیل اینکه کمتر جالب هستند و یا فقط سخت‌تر هستند.
 
-<<<<<<< HEAD
 پس کاملا طبیعی است که یک موتور فقط بخشی از یک استاندارد را پیاده‌سازی کند.
-=======
-So it's quite common for an engine to implement only part of the standard.
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
 
 یک صفحه‌ی خوب برای این که ببینید در حال حاضر چه چیزهایی پشتیبانی می‌شود اینجاست <https://kangax.github.io/compat-table/es6/> (خیلی بزرگ است، ما چیزهای زیادی برای مطالعه داریم).
 
@@ -44,15 +40,9 @@ height = height !== undefined && height !== null ? height : 100;
 
 معمولا توسعه‌دهنده ترنسپایلر را روی کامپیوتر خودش اجرا می‌کند و سپس کد transpileشده را روی سرور deploy می‌کند.
 
-<<<<<<< HEAD
 حالا که صحبتش شد، بهتر است بدانید [Babel](http://babeljs.io/) یکی از برجسته‌ترین ترنسپایلرها است.
 
 سیستم‌های build پروژه مدرن مثل [webpack](https://webpack.js.org/) این امکان را می‌دهند که بعد از هر بار تغییر کد، ترنسپایلر به‌صورت اتوماتیک اجرا شود و برای همین ادغام کردن آن در روند توسعه کار بسیار ساده‌ای است.
-=======
-Speaking of names, [Babel](https://babeljs.io) is one of the most prominent transpilers out there.
-
-Modern project build systems, such as [webpack](https://webpack.js.org/), provide a means to run a transpiler automatically on every code change, so it's very easy to integrate into the development process.
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
 
 ## پلیفیل‌ها
 
@@ -79,34 +69,20 @@ if (!Math.trunc) { // اگر چنین تابعی وجود ندارد
 }
 ```
 
-<<<<<<< HEAD
 جاوااسکریپت یک زبان به‌شدت داینامیک است. اسکریپت‌ها می‌توانند هر تابعی را تغییر دهند یا اضافه کنند. حتی تابع‌های built-in.
 
 دو کتابخانه جالب پلیفیل‌ها:
 - [core js](https://github.com/zloirock/core-js) که از چیزهای زیادی پشتیبانی می‌کند و اجازه می‌دهد فقط فیچرهای مورد نیاز خود را اضافه کنید.
 - [polyfill.io](http://polyfill.io) سرویسی که یک اسکریپت با پلیفیل‌ها ارائه می‌دهد. بسته به فیچرها و مرورگر کاربر.
-=======
-JavaScript is a highly dynamic language. Scripts may add/modify any function, even built-in ones.
-
-Two interesting polyfill libraries are:
-- [core js](https://github.com/zloirock/core-js) that supports a lot, allows to include only needed features.
-- [polyfill.io](http://polyfill.io) service that provides a script with polyfills, depending on the features and user's browser.
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
 
 
 ## خلاصه
 
 در این فصل ما می‌خواهیم به شما انگیزه بدهیم تا بروید و فیچرهای جدید زبان را یاد بگیرید. حتی اگر هنوز توسط موتورهای جاوااسکریپت به‌خوبی پشتیبانی نمی‌شوند.
 
-<<<<<<< HEAD
 فراموش نکنید که از یک ترنسپایلر (اگر از syntax یا عملگرهای مدرن استفاده می‌کنید) و پلیفیل‌ها (برای اضافه کردن تابع‌هایی که ممکن است موجود نباشند) استفاده کنید. و با این کار مطمئن خواهید بود که کد شما کار می‌کند.
 
 برای مثال، بعدها که با جاوااسکریپت آشنایی بیشتری پیدا کنید، می‌توانید یک سیستم build کد با [webpack](https://webpack.js.org/) و پلاگین [babel-loader](https://github.com/babel/babel-loader) راه‌اندازی کنید.
-=======
-Just don't forget to use a transpiler (if using modern syntax or operators) and polyfills (to add functions that may be missing). They'll ensure that the code works.
-
-For example, later when you're familiar with JavaScript, you can setup a code build system based on [webpack](https://webpack.js.org/) with the [babel-loader](https://github.com/babel/babel-loader) plugin.
->>>>>>> 7000ede297bfd688f9a3767e8ca43abd9242f322
 
 منابع خوبی که نشان می‌دهند فیچرهای مختلف در چه حالتی از پشتیبانی قرار دارند:
 - <https://kangax.github.io/compat-table/es6/> - برای جاوااسکریپت.