Merge remote-tracking branch 'upstream/master'

Author: samanzameni

Diff for: .gitignore

@@ -21,3 +21,4 @@ sftp-config.json
 Thumbs.db
 
 
+/svgs

Diff for: 1-js/01-getting-started/1-intro/article.md

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

Diff for: 1-js/01-getting-started/1-intro/limitations.svg

@@ -1,8 +1,8 @@
 # ویرایشگرهای متن 
 
-ویرایشگرهای متن محلی ‌است که برنامه‌نویسان بیشتر وقت خود را آنجا صرف میکنند. 
+ویرایشگرهای متن محلی ‌است که برنامه‌نویسان بیشتر وقت خود را آنجا صرف می‌کنند. 
 
-در مجموع دو نوع ویرایشگر وجود دارد : یکی IDE ها و دیگری ویرایشگرهای سبک برای کد نویسی. بعضی از هر دوی اینها استفاده می‌کنند. 
+در مجموع دو نوع ویرایشگر وجود دارد : یکی IDEها و دیگری ویرایشگرهای سبک برای کد نویسی. بعضی از هر دوی این‌ها استفاده می‌کنند. 
 
 ## IDE
 
@@ -12,52 +12,38 @@
 
 اگر هنوز یک IDE انتخاب نکرده‌اید، موارد زیر را در نظر داشته باشید : 
 
-- [WebStorm](http://www.jetbrains.com/webstorm/) برای توسعه Front End . کمپانی Jetbrains همینطور IDE های دیگری را برای زبان‌های دیگر ارائه می‌کند (که رایگان نیستند) 
-
-- [Netbeans](http://netbeans.org/) (رایگان) 
-
-این IDE ها اصطلاحا Cross Platform هستند. 
+- [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/) نام دارد.  
 
-بعضی از IDE ها پولی هستند ولی برای مدتی به صورت آزمایشی می‌توان از آنها به رایگان استفاده کرد. معمولا قیمت آنها در مقایسه با درآمد برنامه‌نویسان ناچیز است، پس یک IDE خوب برای خود انتخاب کنید. 
+بعضی از IDE ها پولی هستند ولی برای مدتی به صورت آزمایشی می‌توان از آن‌ها به رایگان استفاده کرد. معمولا قیمت آن‌ها در مقایسه با درآمد برنامه‌نویسان ناچیز است، پس یک IDE خوب برای خود انتخاب کنید. 
 
 ## ویرایشگرهای سبک 
 
 این دسته از ویرایشگرها به اندازه IDE ها قدرتمند نیستند، ولی سبک، زیبا و ساده هستند.  
 
 معمولا برای ویرایش سریع یک فایل استفاده می‌شوند. 
 
-تفاوت اصلی بین ویرایشگرهای سبک و IDE ها در آن است که IDE ها در سطح پروژه استفاده می‌‌شوند، در نتیجه در آغاز اطلاعات زیادی را بارگذاری می‌کنند، ساختار پروژه را تحلیل میکنند و موارد این‌چنینی. در زمانیکه بخواهیم روی یک فایل کار کنیم ویرایشگرهای سبک بسیار سریع‌تر هستند. 
-
-در عمل ویرایشگرهای سبک دارای افزونه‌های متعددی هستند، مانند تحلیل‌کننده‌های سینتَکس (syntax)، تکمیل‌کننده های کد و غیره. به همین دلیل نمی‌تواند مرز دقیقی بین IDE و ویرایشگرهای سبک قائل بود. 
-
-موارد زیر ارزش توجه را دارند : 
+تفاوت اصلی بین ویرایشگرهای سبک و IDEها در آن است که IDEها در سطح پروژه استفاده می‌‌شوند، در نتیجه در آغاز اطلاعات زیادی را بارگذاری می‌کنند، ساختار پروژه را تحلیل می‌کنند و موارد این‌چنینی. در زمانیکه بخواهیم روی یک فایل کار کنیم ویرایشگرهای سبک بسیار سریع‌تر هستند. 
 
-- [Visual Studio Code](https://code.visualstudio.com/) : رایگان - Cross Platform و همچنین تعدادی از قابلیت‌های IDE ها را دارد 
+در عمل ویرایشگرهای سبک دارای افزونه‌های متعددی هستند، مانند تحلیل‌کننده‌های سینتَکس (syntax)، تکمیل‌کننده های کد و غیره. به همین دلیل نمی‌توان مرز دقیقی بین IDE و ویرایشگرهای سبک قائل بود. 
 
-- [Atom](https://atom.io/) : رایگان - Cross Platform 
-
-- [Sublime Text](http://www.sublimetext.com) : رایگان برای مدت محدود - Cross Platform 
-
-- [Notepad++](https://notepad-plus-plus.org/) : برای Windows - رایگان 
+موارد زیر ارزش توجه را دارند: 
 
+- [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/) هم اگر با نحوه کارشان آشنا باشید خوب هستند. 
 
-## مورد علاقه‌های من 
-
-ترجیح نویسنده بر آن است که برای پروژه‌ها از IDE و برای کارهای سریع و ساده از ویرایشگرهای سبک استفاده کند. 
-
-من از این نرم‌افزارها استفاده می‌کنم : 
-
-- به عنوان IDE : برای توسعه JavaScript از [WebStorm](http://www.jetbrains.com/webstorm/) (در کار با زبان‌های دیگر از دیگر محصولات JetBrains استفاده می‌کنم) 
-
-- به عنوان یک ویرایشگر سبک : [Sublime Text](http://www.sublimetext.com) یا [Atom](https://atom.io/) 
-
 ## بیایید بحث نکنیم 
 
-ویرایشگرهایی بالا آنهایی هستند که من و دوستانم که آنها را توسعه‌دهندگان خوبی می‌دانم مورد استفاده قرار ‌می‌دهند و راضی هستند. 
+ویرایشگرهای بالا آنهایی هستند که من و دوستانم که آن‌ها را توسعه‌دهندگان خوبی می‌دانم مورد استفاده قرار ‌می‌دهند و راضی هستند. 
 
 ویرایشگرهای دیگری نیز وجود دارند پس همانی که مورد علاقه شماست را انتخاب کنید. 
 
 انتخاب ویرایشگر یا هر ابزار دیگری شخصی بوده و به نوع پروژه، عادات و سلیقه شخصی بستگی دارد. 
+
+نظر شخصی نویسنده:
+
+- اگر من اغلب اوقات فرانت‌اند کار می‌کنم، از [Visual Studio Code](https://code.visualstudio.com/) استفاده خواهم کرد.
+- در غیر این صورت، اگر اکثر اوقات زبان/پلتفرم دیگری کار می‌کنم و کمی فرانت‌اند، دیگر ویرایشگرها را انتخاب می‌کنم مانند XCode (Mac)، Visual Studio (Windows) یا خانواده Jetbrains (بر اساس زبان مورد نظر، Webstorm، PHPStorm، RubyMine و غیره).