Merge pull request #218 from javascript-tutorial/sync-7000ede2

Sync with upstream @ 7000ede

Author: mahdyar

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

@@ -172,22 +172,16 @@
 - [Dart](https://www.dartlang.org/) : که زبانی مستقل با موتور مربوط به خود بوده و در محیط‌های غیر مرورگری (مانند نرم‌افزارهای موبایل) کار می‌کند. این زبان در ابتدا توسط گوگل معرفی شد تا جایگزینی برای جاوا اِسکریپت باشد.  
 - [Brython](https://brython.info/) یک ترانسپایلر پایتون به جاوا اسکریپت است که توسعه دهندگان را قادر می سازد برنامه هایی به زبان پایتون خالص بدون جاوا اسکریپت بنویسند.
 
-@@@needs translation@@@
-@@@old part@@@
 ## خلاصه 
-@@@old part@@@
-@@@new part@@@
-- [CoffeeScript](http://coffeescript.org/) is a "syntactic sugar" for JavaScript. It introduces shorter syntax, allowing us to write clearer and more precise code. Usually, Ruby devs like it.
-- [TypeScript](http://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](http://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.
-@@@new part@@@
-@@@needs translation@@@
+
+- [CoffeeScript](https://coffeescript.org/) یک «syntactic sugar(سینتکس راحت‌تر)» برای جاوااسکریپت است. این زبان سینتکس کوتاه‌تری را معرفی می‌کند که به ما اجازه نوشتن کدی تمیزتر و دقیق‌تر را می‌دهد. معمولا،  توسعه‌دهندگان زبان Ruby آن را دوست دارند.
+- [TypeScript](https://www.typescriptlang.org/) بر روی اضافه کردن «تعیین سخت‌گیرانه نوع داده» تمرکز کرده است تا توسعه و پشتیبانی از سیستم‌های پیچیده را ساده کند. این زبان توسط مایکروسافت توسعه داده شده است.
+- [Flow](https://flow.org/) هم تعیین نوع داده را اضافه کرده است اما به روش دیگری. توسط فیسبوک توسعه داده شده است.
+- [Dart](https://www.dartlang.org/) یک زبان مستقل است که موتور خود را دارد که در محیط‌های غیر مرورگر اجرا می‌شود (مانند اپ‌های موبایل) اما می‌تواند به جاوااسکریپت هم ترجمه شود. توسط گوگل توسعه داده شده است.
+- [Brython](https://brython.info/) یک مترجم پایتون به جاوااسکریپت است که نوشتن یک برنامه به طور کامل در زبان پایتون را بدون جاوااسکریپت مقدور می‌سازد.
+- [Kotlin](https://kotlinlang.org/docs/reference/js-overview.html) یک زبان برنامه‌نویسی مدرن، مختصر و امن است که می‌تواند مرورگر یا Node را مورد هدف قرار دهد.
 
 - جاوا اِسکریپت در ابتدا برای مرورگرها ساخته شده بود ولی در حال حاضر در محیط‌های متفاوتی قابلیت اجرا دارد.  
 - جاوا اِسکریپت در شرایط حاضر موقعیت مشخص و منحصر بفردی در زبان‌های تحت مرورگرها دارد که تطابق کاملی با HTML و CSS را دارا می‌باشد.  
 - زبان‌های مختلفی وجود دارند که به جاوا اِسکریپت تبدیل می‌شوند تا بتوانند ویژگی‌های مشخصی را فراهم کنند. که پیشنهاد می‌کنیم حداقل یکی از آنها را بعد از تسلط به جاوا اِسکریپت مطالعه نمائید.
 
-

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

@@ -3,49 +3,31 @@
 این کتاب یک راهنما است که به شما کمک می‌کند در نهایت این زبان را بیاموزید. اما وقتی که شما با مفاهیم پایه‌ای آشنا شدید، به منابع دیگر نیاز خواهید داشت.
 ## مشخصات (Specification)
 
-**The ECMA-262 specification** شامل عمیق‌ترین، دقیق‌ترین و رسمی‌ترین اطلاعات در جاوا اسکریپت است که زبان را تعریف می‌کند.
+**The ECMA-262 specification** شامل عمیق‌ترین، دقیق‌ترین و رسمی‌ترین اطلاعات در جاوااسکریپت است که زبان را تعریف می‌کند.
 
 اما در ابتدا اگر بخواهیم آنقدر رسمی و دقیق باشیم، درک این زبان سخت می‌شود. بنابراین اگر به منبع اطلاعات قابل اعتماد در مورد جزئیات این زبان نیاز دارید، Specification بهترین مکان است. اما برای استفاده‌ی روزانه نیست.
 
-آخرین نوشته در <https://tc39.es/ecma262/> است.
+یک نسخه جدید از مشخصات هر سال منتشر می‌شود. میان این انتشارها، آخرین مشخصات در <https://tc39.es/ecma262> است.
 
 برای آگاهی از ویژگی‌های به روز که تقریبا استاندارد هستند، به <https://github.com/tc39/proposals> مراجعه کنید.
 
-همینطور اگر به دنبال برنامه‌نویسی مرورگر هستید، به [بخش دوم](info:browser-environment) مراجعه کنید.
-## کتابچه راهنما
 
-**MDN (Mozilla) JavaScript Reference** یک راهنما با مثال‌ها و اطلاعات دیگرست. خوب است که به عمق اطلاعات در مورد توابع زبان و متدها و غیره وارد شوید.
-میتوانید آنرا در <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference> پیدا کنید. 
+**MDN (Mozilla) JavaScript Reference** یک راهنمای اصلی با مثال‌ها و اطلاعات دیگرست. خوب است که به عمق اطلاعات در مورد توابع زبان و متدها و غیره وارد شوید.
 
-اگرچه اغلب اوقات بهتر است که در عوض، یک جستجویی در اینترنت بکنید. در عبارت مورد جستجوی خود "MDN [موضوع مورد نظر]" را قرار دهید. مثلا؛ در جستجوی تابع `parseInt`، <https://google.com/search?q=MDN+parseInt>.
+می‌توانید آنرا در <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference> پیدا کنید. 
 
-- **MSDN**، کتابچه راهنما مایکروسافت با بسیاری اطلاعات که شامل جاوا اسکریپت (که اغلب با اسم JScript آورده شده). اگر کسی به سوالی خاص در Internet Explorer نیاز داشت، بهتر است که به <http://msdn.microsoft.com/> مراجعه کند.
+اگرچه اغلب اوقات بهتر است که در عوض، یک جستجویی در اینترنت انجام دهید. در عبارت مورد جستجوی خود "MDN [موضوع مورد نظر]" را قرار دهید. مثلا؛ در جستجوی تابع `parseInt`، <https://google.com/search?q=MDN+parseInt>. 
 
-@@@needs translation@@@
-@@@old part@@@
-همینطور میتوانیم جستجوی اینترنتی با عباراتی مثل "RegExp MSDN" یا "RegExp MSDN jscript" را انجام دهیم.
-@@@old part@@@
-@@@new part@@@
-## پشتیبانی از ویژگی‌ها (Features)
-- **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.
-@@@new part@@@
-@@@needs translation@@@
+## Compatibility tables
 
-جاوا اسکریپت یک زبان برنامه‌نویسیت که به طور منظم به آن خواص جدیدی اضافه می‌شود. 
+جاوااسکریپت یک زبان برنامه‌نویسیت که به طور منظم به آن خواص جدیدی اضافه می‌شود.
 
-@@@needs translation@@@
-@@@old part@@@
 برای دیدن پشتیبانی مرورگر و بقیه‌ی موتورها این‌ها را ببینید:
 
 - <http://caniuse.com> جدولی بر اساس پشتیبانی خواص. فرضاً برای دیدن اینکه کدام موتورها توابع مدرن  رمزنگاری را پشتیبانی میکند به <http://caniuse.com/#feat=cryptography> مراجعه کنید.
 
 - <https://kangax.github.io/compat-table> جدولی با ویژگی‌های زبان و موتورهایی که قابلیت پشتیبانی آنهارا دارند یا ندارند.
 
-تمام این منابع در توسعه و برنامه‌نویسی‌ در زندگی واقعی مفیدند چراکه بسیاری اطلاعات ارزشمند راجب جزئیات زبان، پشتیبانیشان و غیره را دارند.
-@@@old part@@@
-@@@new part@@@
-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.
-@@@new part@@@
-@@@needs translation@@@
+تمام این منابع در توسعه و برنامه‌نویسی‌ در زندگی واقعی مفید هستند چرا که بسیاری اطلاعات ارزشمند درباره جزئیات زبان، پشتیبانی آن‌ها و غیره را دارند.
 
-این صفحه را وقتی به اطلاعات دقیق یا یک ویژگی خاصی نیاز داشتید به یاد داشته باشید.
+این صفحه را وقتی به اطلاعات عمیق درباره یک ویژگی خاصی نیاز داشتید به یاد داشته باشید.

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

@@ -12,8 +12,8 @@
 
 اگر هنوز یک IDE انتخاب نکرده‌اید، موارد زیر را در نظر داشته باشید : 
 
-- [Visual Studio Code](https://code.visualstudio.com/) : رایگان - Cross Platform و همچنین تعدادی از قابلیت‌های IDE ها را دارد 
-- [WebStorm](http://www.jetbrains.com/webstorm/) برای توسعه Front End . کمپانی Jetbrains همینطور IDE های دیگری را برای زبان‌های دیگر ارائه می‌کند (که رایگان نیستند) 
+- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform، رایگان).
+- [WebStorm](http://www.jetbrains.com/webstorm/) (cross-platform، پولی).
 
 همینطور برای Windows می‌توانید از Visual Studio استفاده کنید (منظور Visual Studio Code نیست). Visual Studio یک نرم افزار غیر رایگان است و فقط بر روی Windows کار می‌کند که برای توسعه پلتفرم dot net مناسب است. نسخه رایگان این نرم افزار [Visual Studio Community](https://www.visualstudio.com/vs/community/) نام دارد.  
 
@@ -31,9 +31,9 @@
 
 موارد زیر ارزش توجه را دارند: 
 
-- [Atom](https://atom.io/): رایگان - Cross Platform 
-- [Sublime Text](http://www.sublimetext.com): رایگان برای مدت محدود - Cross Platform 
-- [Notepad++](https://notepad-plus-plus.org/): برای Windows - رایگان 
+- [Atom](https://atom.io/) (cross-platform، رایگان). 
+- [Sublime Text](http://www.sublimetext.com) (cross-platform، shareware).
+- [Notepad++](https://notepad-plus-plus.org/) (Windows، رایگان)
 - [Vim](http://www.vim.org/) و [Emacs](https://www.gnu.org/software/emacs/) هم اگر با نحوه کارشان آشنا باشید خوب هستند. 
 
 ## بیایید بحث نکنیم 
@@ -42,4 +42,4 @@
 
 ویرایشگرهای دیگری نیز وجود دارند پس همانی که مورد علاقه شماست را انتخاب کنید. 
 
-انتخاب ویرایشگر یا هر ابزار دیگری شخصی بوده و به نوع پروژه، عادات و سلیقه شخصی بستگی دارد. 
+انتخاب ویرایشگر یا هر ابزار دیگری شخصی بوده و به نوع پروژه، عادات و سلیقه شخصی بستگی دارد. 

1-js/02-first-steps/04-variables/article.md

@@ -194,7 +194,7 @@ let my-name; // خط‌های پیوند '-' در نام‌ها ممنوع هس
 ```
 
 ```smart header="بزرگی و کوچکی حروف مهم است"
-متغیر apple با Apple متفاوت است.
+متغیرهای apple و Apple دو متغیر متفاوت هستند.
 ```
 
 ````smart header="کاراکترهای غیر انگلیسی مجاز هستند ولی توصیه نمی‌شوند"
@@ -299,9 +299,9 @@ Constant بودن یک متغیر صرفا بدین معناست که مقدار
 const pageLoadTime = /* زمان بارگیری برای یک صفحه وب */;
 ```
 
-مقدار ثابت `pageLoadTime` پیش از اجرای برنامه مشخص نبوده و به همین دلیل به صورت عادی نوشته شده است. اما همچنان یک ثابت است چراکه زمان اجرای برنامه بعد از مقدار دهی دیگر تغییر نخواهد کرد.
+مقدار `pageLoadTime` پیش از اجرای برنامه مشخص نبوده و به همین دلیل به صورت عادی نوشته شده است. اما همچنان یک ثابت است چراکه زمان اجرای برنامه بعد از مقدار دهی دیگر تغییر نخواهد کرد.
 
-به تعبیری دیگر ثابت‌های با حروف بزرگ زمانی که اصطلاحا مقداری به صورت "hard code" شده داریم، به عنوان نام مستعار استفاده می‌شوند.
+به تعبیری دیگر، ثابت‌های با حروف بزرگ فقط به عنوان نام مستعار برای مقدار های «hard-coded» استفاده می‌شوند.
 
 ## نام‌های مناسب انتخاب کنید
 
@@ -342,4 +342,4 @@ const pageLoadTime = /* زمان بارگیری برای یک صفحه وب */;
 - `var` -- حالت قدیمی تعریف متغیر می‌باشد. معمولا اصلا از این روش استفاده نمی‌کنیم، اما تفاوت‌های آن را در بخش <info:var> بیان خواهیم کرد تا در صورت نیاز بتوانید از آن استفاده نمایید.
 - `const` -- همانند `let` است با این تفاوت که مقدار آن قابل تغییر نیست.
 
-نام متغیرها باید به گونه‌ای باشد که به ما اجازه دهد به راحتی متوجه شویم چه چیزی درون آن است.
+نام متغیرها باید به گونه‌ای باشد که به ما اجازه دهد به راحتی متوجه شویم چه چیزی درون آن است.