Merge pull request #3 from javascript-tutorial/sync-29a3c58d

Sync with upstream @ 29a3c58

Author: mehradsadeghi

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

@@ -6,7 +6,11 @@
 
 
 
+<<<<<<< HEAD
 ## جاوا اسکریپت چیست  
+=======
+The programs in this language are called *scripts*. They can be written right in a web page's HTML and run automatically as the page loads.
+>>>>>>> 29a3c58d72b8f10f9f1f9ce5cf691d2ab44a9d01
 
 
 
@@ -39,7 +43,11 @@
 [موتور جاوااِسکریپت](https://en.wikipedia.org/wiki/JavaScript_engine)
  وجود داشته باشد، این زبان قابلیت اجرا شدن را داراست.  
 
+<<<<<<< HEAD
 مرورگرهای وب دارای موتوری داخلی برای اجرای جاوا اِسکریپت هستند، که گاهی آن را  **ماشین مجازی جاوا** **اِسکریپت** نیز می‌نامند.  
+=======
+JavaScript's capabilities greatly depend on the environment it's running in. For instance, [Node.js](https://wikipedia.org/wiki/Node.js) supports functions that allow JavaScript to read/write arbitrary files, perform network requests, etc.
+>>>>>>> 29a3c58d72b8f10f9f1f9ce5cf691d2ab44a9d01
 
 
 
@@ -59,7 +67,11 @@
 
 بخاطر سپردن این نام‌ها مفید هستند، چراکه در مقالات مختلف به آنها بر خواهید خورد، همینطور زمانیکه ما در این آموزش برای نمونه می‌گوییم ویژگی X توسط موتور **V8** پشتیبانی می‌شود، یعنی به احتمال زیاد در مرورگرهای کروم و اپرا پشتیبانی خواهد شد.  
 
+<<<<<<< HEAD
 
+=======
+    This is called the "Same Origin Policy". To work around that, *both pages* must agree for data exchange and contain a special JavaScript code that handles it. We'll cover that in the tutorial.
+>>>>>>> 29a3c58d72b8f10f9f1f9ce5cf691d2ab44a9d01
 
 **موتورها** **چگونه کار** **می‌کنند** 
 
@@ -71,6 +83,7 @@
 
 
 
+<<<<<<< HEAD
 ۱. موتور در ابتدا اِسکریپت را می‌خواند (Parse).  
 
 
@@ -190,6 +203,14 @@
 
 
 نمونه‌هایی از این زبان‌ها :  
+=======
+```compare
++ Full integration with HTML/CSS.
++ Simple things are done simply.
++ Support by all major browsers and enabled by default.
+```
+JavaScript is the only browser technology that combines these three things.
+>>>>>>> 29a3c58d72b8f10f9f1f9ce5cf691d2ab44a9d01
 
 
 

1-js/01-getting-started/1-intro/limitations.png

@@ -46,7 +46,19 @@
 
 ![safari](safari.png)
 
+<<<<<<< HEAD
 حالا `cmd + opt + c` می‌‌تواند پنل توسعه دهندگان را باز کند. 
+=======
+Now `key:Cmd+Opt+C` can toggle the console. Also, note that the new top menu item named "Develop" has appeared. It has many commands and options.
+
+## Multi-line input
+
+Usually, when we put a line of code into the console, and then press `key:Enter`, it executes.
+
+To insert multiple lines, press `key:Shift+Enter`.
+
+## Summary
+>>>>>>> 29a3c58d72b8f10f9f1f9ce5cf691d2ab44a9d01
 
 ## ورودی چند خطی
 

1-js/01-getting-started/1-intro/limitations@2x.png

@@ -1,10 +1,18 @@
 # Hello, world!
 
+<<<<<<< HEAD
 آموزش پیش روی شما مفاهیم هسته‌ای جاوا اسکریپت است که وابسته به پلتفرم نیست. در ادامه با پلتفرم‌هایی مانند Node.JS و نحوه استفاده از آنها آشنا خواهیم شد.
 
 ما برای اجرای اسکریپت‌هایی که می‌نویسیم به محیطی برای اجرا نیاز داریم و از آنجایی که این یک دوره آنلاین است، مرورگر انتخاب خوبی است. سعی ما بر این است تا از دستوراتی که اختصاصا مربوط به مرورگر هستند مانند `alert` کمتر استفاده کنیم. مخصوصا برای شمایی قصد استفاده از جاوا اسکریپت در پلتفرم‌های دیگری چون Node.JS را دارید.
 
 پس ابتدا نگاهی به نحوه متصل کردن یک اسکریپت به یک صفحه وب می‌اندازیم. اگر در محیط Server Side هستید (مانند Node.JS) می‌توانید از این دستور برای اجرای اسکریپت استفاده نمایید : `node my.js`
+=======
+The tutorial that you're reading is about core JavaScript, which is platform-independent. Later on, you'll learn about Node.js and other platforms that use it.
+
+But we need a working environment to run our scripts and, since this book is online, the browser is a good choice. We'll keep the amount of browser-specific commands (like `alert`) to a minimum so that you don't spend time on them if you plan to concentrate on another environment (like Node.js). We'll focus on JavaScript in the browser in the [next part](/ui) of the tutorial.
+
+So first, let's see how we attach a script to a webpage. For server-side environments (like Node.js), you can execute the script with a command like `"node my.js"`.
+>>>>>>> 29a3c58d72b8f10f9f1f9ce5cf691d2ab44a9d01
 
 ## تگِ script
 

1-js/01-getting-started/3-devtools/article.md

@@ -153,4 +153,8 @@ alert( 'World' );
 
 Comment ها حجم کد را افزایش می‌دهند، اما این اصلا اشکال نیست. ابزارهای گوناگونی وجود دارند که قبل از انتشار برنامه روی سروِر کدهای شما را کم حجم و Comment ها را حذف می‌کنند. بنابراین Comment ها روی خروجی نهایی تاثیری نخواهند داشت.
 
+<<<<<<< HEAD
 در ادامه آموزش در بخش <info:coding-style> نحوه بهتر نوشتن Comment ها را خواهیم آموخت.
+=======
+Later in the tutorial there will be a chapter <info:code-quality> that also explains how to write better comments.
+>>>>>>> 29a3c58d72b8f10f9f1f9ce5cf691d2ab44a9d01

1-js/02-first-steps/01-hello-world/article.md

@@ -65,10 +65,6 @@ alert("some code");
 })()
 ```
 
-## همیشه از "use strict" استفاده کنید
-
-ما همچنان باید به آموختن تفاوت‌های use strict و default mode ادامه دهیم.
-
 در بخش‌های بعدی که با قابلیت‌های زبان جاوا اسکریپت آشنا می‌شویم، به تفاوت‌های بین strict mode و "default" mode اشاره خواهیم کرد و خواهیم دید که use strict چطور زندگی ما را راحت‌تر کرده است.
 
 تا به اینجا کافیست بدانید :

1-js/02-first-steps/01-hello-world/hello-world-render.png

@@ -53,7 +53,13 @@ alert(message); // Hello!
 let user = 'John', age = 25, message = 'Hello';
 ```
 
+<<<<<<< HEAD
 این مورد ممکن است کوتاه‌تر به نظر آید اما ما پیشنهاد نمی‌کنیم. چراکه خوانایی را پایین می‌آورد. لطفا برای تعریف متغیرها از خطوط جداگانه استفاده کنید :
+=======
+That might seem shorter, but we don't recommend it. For the sake of better readability, please use a single line per variable.
+
+The multiline variant is a bit longer, but easier to read:
+>>>>>>> 29a3c58d72b8f10f9f1f9ce5cf691d2ab44a9d01
 
 ```js
 let user = 'John';
@@ -132,8 +138,13 @@ alert(hello); // Hello world!
 alert(message); // Hello world!
 ```
 
+<<<<<<< HEAD
 ```smart header="زبان‌های Functional"
 جالب است بدانید زبان‌های [functional](https://en.wikipedia.org/wiki/Functional_programming) مانند [Scala](http://www.scala-lang.org/) یا [Erlang](http://www.erlang.org/) تغییر مقدار متغیر را ممنوع کرده‌اند.
+=======
+```smart header="Functional languages"
+It's interesting to note that there exist [functional](https://en.wikipedia.org/wiki/Functional_programming) programming languages, like [Scala](http://www.scala-lang.org/) or [Erlang](http://www.erlang.org/) that forbid changing variable values.
+>>>>>>> 29a3c58d72b8f10f9f1f9ce5cf691d2ab44a9d01
 
 در این نوع زبان‌ها وقتی مقداری را در جعبه قرار می‌دهیم تا ابد آنجا می‌ماند و اگر بخواهیم مقداری دیگر را ذخیره کنیم، ما را مجبور می‌کنند تا جعبه‌ای جدید بسازیم.
 
@@ -155,7 +166,11 @@ let userName;
 let test123;
 ```
 
+<<<<<<< HEAD
 زمانی‌که به یک نام متشکل از چند کلمه است، عموما از روش [camelCase](https://en.wikipedia.org/wiki/CamelCase) استفاده می‌شود. به این صورت که کلمات یکی پس از دیگری پشت هم نوشته می‌شوند و حرف اول هر کلمه کاراکتر بزرگ هست : `myVeryLongName` .
+=======
+When the name contains multiple words, [camelCase](https://en.wikipedia.org/wiki/CamelCase) is commonly used. That is: words go one after another, each word except first starting with a capital letter: `myVeryLongName`.
+>>>>>>> 29a3c58d72b8f10f9f1f9ce5cf691d2ab44a9d01
 
 همینطور از `'$'` و `'_'` نیز می‌توان استفاده نمود. معنی خاصی ندارند و همانند حروف قابل استفاده هستند.
 
@@ -180,8 +195,13 @@ let my-name; // hyphens '-' aren't allowed in the name
 متغیر apple با Apple متفاوت است.
 ```
 
+<<<<<<< HEAD
 ````smart header="کاراکترهای غیر انگلیسی مجاز هستند ولی توصیه نمی‌شوند"
 امکان استفاده از کاراکترهای زبان‌های دیگر وجود دارد. مانند :
+=======
+````smart header="Non-Latin letters are allowed, but not recommended"
+It is possible to use any language, including cyrillic letters or even hieroglyphs, like this:
+>>>>>>> 29a3c58d72b8f10f9f1f9ce5cf691d2ab44a9d01
 
 ```js
 let имя = '...';
@@ -251,7 +271,11 @@ myBirthday = '01.01.2001'; // error, can't reassign the constant!
 
 به صورت یک عُرفِ همه‌گیر، از ثابت‌های با حروف بزرگ به عنوان نام مستعار برای مقادیری که به خاطر سپردن آنها دشوار است، استفاده می‌شود. این دسته از ثابت‌ها اصطلاحا prior to execution (پیش از اجرای برنامه) مقدارشان قطعی است.
 
+<<<<<<< HEAD
 در ثابت‌ها از حروف بزرگ و _ استفاده می‌شود :
+=======
+For instance, let's make constants for colors in so-called "web" (hexadecimal) format:
+>>>>>>> 29a3c58d72b8f10f9f1f9ce5cf691d2ab44a9d01
 
 ```js run
 const COLOR_RED = "#F00";
@@ -285,7 +309,11 @@ const pageLoadTime = /* time taken by a webpage to load */;
 
 ## نام‌های مناسب انتخاب کنید
 
+<<<<<<< HEAD
 لطفا نام متغیرهای خود را با حساسیت انتخاب کنید و برای اینکار خوب فکر کنید.
+=======
+A variable name should have a clean, obvious meaning, describe the data that it stores.
+>>>>>>> 29a3c58d72b8f10f9f1f9ce5cf691d2ab44a9d01
 
 انتخاب نام برای متغیرها یکی از کارهای مهم و پیچیده در برنامه‌نویسی است. یک نگاه سریع به نام متغیرها می‌تواند تفاوت یک برنامه‌نویس تازه‌کار و با تجربه را نشان دهد.