merging all conflicts

Author: iliakan

1-js/02-first-steps/09-comparison/article.md

@@ -4,10 +4,17 @@
 
 : وفي لغة الجافسكريبت تكتب كما يلي 
 
+<<<<<<< HEAD
 - أكبر/أصغر من: <code>a &gt; b</code>, <code>a &lt; b</code>.
 - أكبر/أصغر من او يساوي: <code>a &gt;= b</code>, <code>a &lt;= b</code>.
 - يساوي: `a == b` ، يرجى ملاحظة أن علامة المساواة المزدوجة` = `تعني اختبار المساواة ، في حين أن كلمة واحدة` a = b` تعني  تعيين أو مساواة .
 - لا تساوي. في الرياضيات يكون الترميز <code>&ne;</code> ،لكن في JavaScript تكتب هكذا <code>a != b</code>.
+=======
+- Greater/less than: <code>a &gt; b</code>, <code>a &lt; b</code>.
+- Greater/less than or equals: <code>a &gt;= b</code>, <code>a &lt;= b</code>.
+- Equals: `a == b`, please note the double equality sign `==` means the equality test, while a single one `a = b` means an assignment.
+- Not equals. In maths the notation is <code>&ne;</code>, but in JavaScript it's written as <code>a != b</code>.
+>>>>>>> c3a11c85e54153ebb137b5541b1d1f751c804439
 
 في هذه المقالة سنتعلم المزيد عن الأنواع المختلفة من المقارنات ، وكيف تجعلها JavaScript، بما في ذلك الخصائص المهمة.
 

1-js/04-object-basics/07-optional-chaining/article.md

@@ -40,8 +40,12 @@ alert( user && user.address && user.address.street ); // يظهر لنا undefin
 
 يؤدي التسلسل الاختياري `.?` إلى إيقاف تقييم الكود البرمجي وإرجاع `undefined` إذا كانت قيمة الجزء الموجود قبل (أيسر) التركيب `.?` هي `null` أو `undfined`.
 
+<<<<<<< HEAD
 وللإيجاز، سنقول ضمن هذه المقالة أن شيئاً ما "موجود" إذا لم تكن قيمته `null` ولم تكن `undefined` كذلك.
 
+=======
+**Further in this article, for brevity, we'll be saying that something "exists" if it's not `null` and not `undefined`.**
+>>>>>>> c3a11c85e54153ebb137b5541b1d1f751c804439
 
 وأما الطريقة الآمنة للوصول لـِ `user.address.street` هي:
 
@@ -57,14 +61,20 @@ alert( user?.address?.street ); // سيظهر لنا بدون حدوث خطأ un
 let user = null;
 
 alert( user?.address ); // undefined
-
 alert( user?.address.street ); // undefined
-alert( user?.address.street.anything ); // undefined
 ```
 
+<<<<<<< HEAD
 يرجى ملاحظة أن التركيب أو الشقّ `.?` يعمل بشكل صحيح حيث يتم وضعه بالضبط، وليس بعد ذلك المكان الذي تم وضعه فيه.
 
 في السطرين الأخيرين، سيتوقف تقييم الكود البرمجي بشكل فوري بعد الشقّ `.?user` ولا يستمر أبداً للخصائص التي تليه. ولكن إذا كان الغرض `user` موجوداً بالفعل، فيجب أن تكون الخصائص الوسيطة موجودة ونقصد بالخصائص الوسيطة `user.address` مثلاً.
+=======
+Please note: the `?.` syntax makes optional the value before it, but not any further.
+
+In the example above, `user?.` allows only `user` to be `null/undefined`.
+
+On the other hand, if `user` does exist, then it must have `user.address` property, otherwise `user?.address.street` gives an error at the second dot.
+>>>>>>> c3a11c85e54153ebb137b5541b1d1f751c804439
 
 ```warn header="لا تفرط في استخدام تركيب التسلسل الاختياري"
 يجب أن نستخدم التركيب `.?` فقط عندما يكون هناك غرض، كائن أو خاصية غير موجودة بالأصل.
@@ -74,14 +84,23 @@ alert( user?.address.street.anything ); // undefined
 وبالتالي، إذا كان غرض المستخدم `user` غير معرف بسبب خطأ ما، فسوف نعرف عن هذا الخطأ ونصلحه. وإلا ستتسبب هذه الطريقة بإسكات الأخطاء البرمجية وقد لا يكون ذلك مناسباً، بل سيصبح من الصعب تصحيح هذه الأخطاء وكشفها.
 ```
 
+<<<<<<< HEAD
 ````warn header="المتحول الواقع قبل التركيب `.?` يجب أن يكون معرّفاً"
 إذا لم يتمّ تعريف المتحول `user`، سيؤدي التعبير `user?.anything` إلى حصول خطأ:
+=======
+````warn header="The variable before `?.` must be declared"
+If there's no variable `user` at all, then `user?.anything` triggers an error:
+>>>>>>> c3a11c85e54153ebb137b5541b1d1f751c804439
 
 ```js run
 // ReferenceError: user is not defined
 user?.address;
 ```
+<<<<<<< HEAD
 يقوم التسلسل الاختياري فقط باختبار القيم `null/undefined`، ولا يتداخل مع ميكانيكية أي من اللغات الأخرى.
+=======
+There must be `let/const/var user`. The optional chaining works only for declared variables. 
+>>>>>>> c3a11c85e54153ebb137b5541b1d1f751c804439
 ````
 
 ## اختصار الطرق (Short-circuiting)