Merge branch 'master' into advancedbranch

Author: OmarioHassan

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

@@ -1,40 +1,40 @@
 # المراجع و المواصفات
 
-هذا الكتاب هو _دورة تعليميه_. يهدف الى تعليمك اللغه تدريجيا. و لكن إذا كنت علي علم بالأساسيات فسوف تحتاج الى مصدر آخر.
+هذا الكتاب هو _دورة تعليمية_. يهدف الى تعليمك اللغه تدريجيا. و لكن إذا كنت علي علم بالأساسيات فسوف تحتاج إلى مصدر آخر.
 
 ## الوصف
 
-[وصف The ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) يحتوي على المعلومات الإكثر عمقاً و تفصيلاً و رسميةً عن جافاسكريبت.و هي تقوم بتعريف اللغه.
+[وصف The ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) يحتوي على المعلومات الأكثر عمقاً وتفصيلاً ورسميةً عن جافاسكريبت. وهي تقوم بتعريف اللغة.
 
-و لكن كونها بهذه الرسمية, تجعل فهمها من اول مره صعب. لذلك إذا كنت تريد مصدر المعلومه الأكثر وثوقاً عن تفاصيل اللغه, الوصف هو المكان الصحيح. لكنها ليست للإستعمال اليومي.
+و لكن كونها بهذه الرسمية، تجعل فهمها من أول مرة صعبا. لذلك إذا كنت تريد مصدر المعلومى الأكثر وثوقاً عن تفاصيل اللغة، الوصف هو المكان الصحيح. لكنها ليست للإستعمال اليومي.
 
-نسخة وصف جديدة تُصدر كل عام. فيما بين هذه الإصدارات, آخر مسودة وصف توجد في <https://tc39.es/ecma262/>.
+نسخة وصف جديدة تُصدر كل عام. فيما بين هذه الإصدارات، آخر مسودة وصف توجد في <https://tc39.es/ecma262/>.
 
-لكى تقرأ عن خصائص التطور الحاد الجديد, بما فى ذلك "المعايير التقريبيه" (ما يسمي "المرحلة 3"), انظر للمقترحات في <https://github.com/tc39/proposals>.
+لكي تقرأ عن خصائص التطور الحاد الجديد، بما فى ذلك "المعايير التقريبية" (ما يسمي "المرحلة 3")، انظر للمقترحات في <https://github.com/tc39/proposals>.
 
-أيضاً, إذا كنت تطور من أجل المتصفح, إذاهناك مواصفات اخري مشمولة في [الجزء الثاني](info:browser-environment) من الدورة التعليميه.
+أيضاً، إذا كنت تطور من أجل المتصفح، إذا هناك مواصفات أخرى مشمولة في [الجزء الثاني](info:browser-environment) من الدورة التعليمية.
 
 ## المراجع
 
-- **MDN (Mozilla) JavaScript Reference** هذا دليل بأمثلة ومعلومات أخرى. مصدر جيد للحصول على معلومات تفصيلية حول ميزات اللغة ، وطرق الكائنات المضمنة ، وما إلى ذلك.
+- **MDN (Mozilla) JavaScript Reference** هذا دليل بأمثلة ومعلومات أخرى. وهو مصدر جيد للحصول على معلومات تفصيلية حول ميزات اللغة، وطرق الكائنات المضمنة، وما إلى ذلك.
 
-  يمكن ان تجدها في <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
+يمكن أن تجدها في <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
 
-  ايضاً, غالباً ما يكون من الأفضل استخدام بحث عبر الإنترنت بدلاً من ذلك. فقط إستخدم "[مصطلح] MDN" للإستعلام, مثال. <https://google.com/search?q=MDN+parseInt> لتبحث عن دالة `parseInt`.
+أيضاً، غالباً ما يكون من الأفضل استخدام البحث عبر الإنترنت بدلاً من ذلك. فقط استخدم "[مصطلح] MDN" للإستعلام، مثال <https://google.com/search?q=MDN+parseInt> لتبحث عن دالة `parseInt`.
 
-* **MSDN** – مراجع ميكروسوفت يوجد بها معلومات كثيرة, متضمنه جافاسكريبت (غالباً يشار إليها JScript). إذا كنت تريد شيئا أكثر تخصصا عن انترنت اكسبلورر, من الأفضل الذهاب إلى: <http://msdn.microsoft.com/>.
+* **MSDN** – مراجع ميكروسوفت يوجد بها معلومات كثيرة، متضمنة جافاسكريبت (غالباً يشار إليها JScript). إذا كنت تريد شيئا أكثر تخصصا عن انترنت اكسبلورر، من الأفضل الذهاب إلى: <http://msdn.microsoft.com/>.
 
-  أيضاً, يمكن غن نستخدم بحث الإنترنت بعبارات مثل "RegExp MSDN" or "RegExp MSDN jscript".
+أيضاً، يمكن غن نستخدم بحث الإنترنت بعبارات مثل "RegExp MSDN" or "RegExp MSDN jscript".
 
 ## جدول التوافق
 
-جافاسكريبت لغه فى سياق متطور, خصائص جديدة تضاف إليها بإنتظام.
+جافاسكريبت لغة فى سياق متطور، تضاف إليها خصائص جديدة بانتظام.
 
-لتري دعمهم ما بين المتصفحات و المحركات الأخري, أنظر:
+لتَّـحَقّـق من الدعم ما بين المتصفحات والمحركات الأخرى، انظر:
 
-- <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> - جدول بمواصفات ومحركات اللغة وقابلية دعم كل محرك لكل خاصية.
 
-كل هذه المصادر مفيدة في تطوير الحياة الواقعيه, لأنها تحتوي علي معلومات قيّمة عن تفاصيل و دعم اللغة .
+كل هذه المصادر مفيدة في تطوير الحياة الواقعية، لأنها تحتوي علي معلومات قيّمة عن تفاصيل ودعم اللغة.
 
-من فضلك تذكر هذه المصادر (او هذه الصفحه) فى حالات إذا كنت تريد معلومات اعمق عن خاصية معينة.
+من فضلك تذكر هذه المصادر (أو هذه الصفحة) فى حالات إذا كنت تريد معلومات أعمق عن خاصية معينة.

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

@@ -2,44 +2,42 @@
 
 محرر الأكواد هو المكان الذي يقضي فيه المبرمجون معظم وقتهم.
 
-يوجد نوعين من محررات الأكواد: IDEs ( بيئة التطوير الكاملة)و المحررات البسيطة. العديد من الناس يستخدمون أداة واحدة لكل نوع.
+يوجد نوعين من محررات الأكواد: IDEs (بيئة التطوير الكاملة) والمحررات البسيطة. العديد من الناس يستخدمون أداة واحدة لكل نوع.
 
 ## IDE
 
-مصطلح [IDE](https://en.wikipedia.org/wiki/Integrated_development_environment) (Integrated Development Environment) يشير إلى محرر بإمكانات هائلة، مع العديد من المميزات التي تعمل عادة على " مشروع كامل". كما يوحي الاسم، فهو ليس مجرد محرر أكواد، ولكنه "بيئة تطوير" واسعة النطاق.
+مصطلح [IDE](https://en.wikipedia.org/wiki/Integrated_development_environment) (Integrated Development Environment) يشير إلى محرر بإمكانات هائلة، مع العديد من المميزات التي تعمل عادة على "مشروع كامل". كما يوحي الاسم، فهو ليس مجرد محرر أكواد، ولكنه "بيئة تطوير" واسعة النطاق.
 
- IDE تقوم بتحميل المشروع ) الذي يمكن أن يتكون من العديد من الملفات)، ويسمح بالتنقل بين الملفات، ويوفر خاصة الإكمال التلقائي المعتمدة على المشروع ككل ( وليس الملف المفتوح فقط) , كما أنه يمكن أن يرتبط مع أنظمة إدارة الإصدار  (مثل [git](https://git-scm.com/)), وبيئة الاختبار, وغيرها من الأشياء على مستوى المشروع.
+ IDE تقوم بتحميل المشروع (الذي يمكن أن يتكون من العديد من الملفات)، ويسمح بالتنقل بين الملفات، ويوفر خاصة الإكمال التلقائي المعتمدة على المشروع ككل ( وليس الملف المفتوح فقط)، كما أنه يمكن أن يرتبط مع أنظمة إدارة الإصدار (مثل [git](https://git-scm.com/))، وبيئة الاختبار، وغيرها من الأشياء على مستوى المشروع.
 
-إذا لم تقم باختيار IDE بعد ، ففكر في الخيارات التالية:
+إذا لم تقم باختيار IDE بعد، ففكر في الخيارات التالية:
 
-- [فيجوال ستديو كود](https://code.visualstudio.com/) (يعمل على أكثر من نظام تشغيل, مجاني).
-- [ويب ستورم](http://www.jetbrains.com/webstorm/) (يعمل على أكثر من نظام تشغيل, مدفوع).
+- [فيجوال ستديو كود](https://code.visualstudio.com/) (يعمل على أكثر من نظام تشغيل، مجاني).
+- [ويب ستورم](http://www.jetbrains.com/webstorm/) (يعمل على أكثر من نظام تشغيل، مدفوع).
 
-بالنسبة للويندوز، يمكن استخدام برنامج فيجوال ستديو، لايجب الخلط بينه وبين الفيجوال ستديو كود، فيجوال ستديو هو محرر  مدفوع يعمل على نظام ويندوز فقك، ومناسب تماماً لبيئة الدوت نت. أنه أيضاً جيد للجافاسكريبت. كما يوجد إصدار مجاني منه [Visual Studio Community](https://www.visualstudio.com/vs/community/).
+بالنسبة للويندوز، يمكن استخدام برنامج فيجوال ستديو، لايجب الخلط بينه وبين الفيجوال ستديو كود، فيجوال ستديو هو محرر مدفوع يعمل على نظام ويندوز فقط، ومناسب تماماً لبيئة الـ.NET. أنه أيضاً جيد للجافاسكريبت. كما يوجد إصدار مجاني منه [Visual Studio Community](https://www.visualstudio.com/vs/community/).
 
-.عادة ما تكون تكلفتها ضئيلة للغاية مقارنة براتب المطور المؤهل ، لذلك فقط اختر الأفضل بالنسبة لك.العديد من بيئات التطوير مدفوعة، لكن لها فترة سماحية
+عادة ما تكون تكلفتها ضئيلة للغاية مقارنة براتب المطور المؤهل، لذلك فقط اختر الأفضل بالنسبة لك. العديد من بيئات التطوير مدفوعة، لكن لها فترة سماحية.
 
 ## المحررات البسيطة
 
-المحررات البسيطة"  ليست بقوة ال"  IDEs لكنها سريعة, وأنيقة وبسيطة
+المحررات البسيطة ليست بقوة البيئات التطوير لكنها سريعة، وأنيقة وبسيطة، يتم استخدامها بشكل رئيس لفتح وتحرير ملف على الفور.
 
-يتم استخدامها بشكل رئيسي لفتح وتحرير ملف على الفور.
+الفارق الرئيس بين المحررات البسيطة وبيئة التطوير هو أن بيئة التطوير تعمل على مستوى المشروع، لذلك فإنها تقوم بتحميل المزيد من البيانات عند البدء، وتحليل هيكل المشروع إذا لزم ذلك. أما المحررات البسيطة فإنها أسرع في حال نريد ملف واحد فقط.
 
-الفارق الرئيسي بين المحررات البسيطة و "بيئة التطوير" هو أن بيئة التطوير تعمل على مستوى المشروع، لذلك فإنها تقوم بتحميل المزيد من البيانات عند البدء، وتحليل هيكل المشروع إذا لزم ذلك. أما المحررات البسيطة فإنها أسرع في حال نريد ملف واحد فقط.
-
-من الناحية العملية ، قد تحتوي المحررات البسيطة على الكثير من المكونات الإضافية بما في ذلك محللات بناء الجملة على مستوى الدليل وأجهزة الإكمال التلقائي ، لذلك لا توجد حدود صارمة بين المحرر البسيط و IDE.
+من الناحية العملية، قد تحتوي المحررات البسيطة على الكثير من المكونات الإضافية بما في ذلك محللات بناء الجملة على مستوى الدليل وأجهزة الإكمال التلقائي، لذلك لا توجد حدود صارمة بين المحرر البسيط وبيئة التطوير.
 
 الخيارات التالية تستحق انتباهك:
 
-- [Atom](https://atom.io/) (يعمل على العديد من أنظمة التشغيل, مجاني).
-- [Visual Studio Code](https://code.visualstudio.com/) (يعمل على العديد من أنظمة التشغيل, مجاني).
-- [Sublime Text](http://www.sublimetext.com) (يعمل على العديد من أنظمة التشغيل, برنامج مشاركة).
-- [Notepad++](https://notepad-plus-plus.org/) (الويندوز, مجاني).
-- [Vim](http://www.vim.org/) و [Emacs](https://www.gnu.org/software/emacs/)  رائعة إذا كنت تعرف كيفية استخدامها.
+- [Atom](https://atom.io/) (يعمل على العديد من أنظمة التشغيل، مجاني).
+- [Visual Studio Code](https://code.visualstudio.com/) (يعمل على العديد من أنظمة التشغيل، مجاني).
+- [Sublime Text](http://www.sublimetext.com) (يعمل على العديد من أنظمة التشغيل، برنامج مشاركة).
+- [Notepad++](https://notepad-plus-plus.org/) (الويندوز، مجاني).
+- [Vim](http://www.vim.org/) و [Emacs](https://www.gnu.org/software/emacs/) رائعة إذا كنت تعرف كيفية استخدامها.
 
-## دعونا لانتشاجر
+## دعونا لا نتشاجر
 
-المحررات التي بالقائمة الأعلى هي التي نقوم باستخدامها أنا وأصدقائي، والذين أعتقد أنهم مطورون جيدون يستخدمونها منذ وقت طويل وتسعدهم.
+المحررات أعلاه هي التي نقوم باستخدامها أنا وأصدقائي، والذين أعتقد أنهم مطورون جيدون يستخدمونها منذ وقت طويل وتسعدهم.
 
 يوجد أيضاً محررات رائعة في عالمنا الكبير، الرجاء اختيار المحرر الذي تفضله.