مراجعة تغيير

تقدّم هذه الوثيقة تعليمات حول كيفية مراجعة تغيير. ضَع في اعتبارك المعايير التالية لإجراء تغيير صالح:

• هل يتناسب هذا التغيير مع الغرض المُعلن لهذا المشروع؟
• هل هذا التغيير صالح ضمن البنية الحالية للمشروع؟
• هل يُدخِل هذا التغيير عيوبًا في التصميم قد تتسبّب في حدوث مشاكل في المستقبل؟
• هل يتّبع هذا التغيير أفضل الممارسات التي تم وضعها لهذا المشروع؟
• هل هذا التغيير طريقة جيدة لتنفيذ الوظيفة الموصوفة؟
• هل يُدخِل هذا التغيير أي مخاطر أمنية أو مخاطر تؤدي إلى عدم الاستقرار، أو هل يؤدي إلى إيقاف أي تطبيقات حالية؟

لمزيد من المعلومات حول مراجعة تغيير، يُرجى الاطّلاع على مراجعة تغيير قسم في مستندات Gerrit.

إذا تم تعيينك كمراجع لتغيير، من المفترض أن تتلقّى رسالة إلكترونية تتضمّن رابطًا يؤدي إلى التغيير. اتّبِع الخطوات التالية لمراجعة التغيير:

1. انقر على رابط التغيير في الرسالة الإلكترونية. تظهر شاشة "معلومات التغيير" (Change Info) في Gerrit. تقدّم هذه الشاشة وصفًا للتغيير، وتحدّد مساهم التغيير وجميع المراجعين، وتقدّم قائمة بالملفات المرتبطة بالتغيير.

2. اقرأ وصف التغيير لفهم هدفه.

3. انقر على ملف لمراجعة التغييرات في الملف. يُفتح الملف في شاشة مقارنة بين لوحتَين، حيث يظهر الملف الحالي على اليمين والملف الذي يتضمّن التغييرات المقترَحة على اليسار. لمراجعة الملف:

   1. استخدِم الماوس لتظليل (النقر مع السحب) جزء الرمز الذي لديك تعليق أو سؤال بشأنه. تظهر الرسالة "اضغط على c لإضافة تعليق".

   2. اضغط على c. يظهر مربّع تعليق مسودة.

   3. أدخِل تعليقك أو سؤالك وانقر على حفظ.

4. انقر على الرقم الفريد للتغيير (أعلى يمين الشاشة) للعودة إلى شاشة "معلومات التغيير" (Change Info).

5. تابِع مراجعة كل ملف في التغيير.

6. عند الانتهاء من مراجعة جميع الملفات في التغيير، ارجع إلى شاشة "معلومات التغيير" (Change Info) وانقر على رد (REPLY). تظهر شاشة "أصوات متطلبات الإرسال" (Submit requirement votes).

7. اختَر إحدى النتائج التالية للتغيير:

   • +1 يبدو لي جيدًا، ولكن يجب أن يوافق عليه شخص آخر أيضًا.

   • 0 ما مِن نتيجة

   • -1 أفضّل عدم إرسال هذا التغيير كما هو، لأنّه يتضمّن عناصر يجب إصلاحها.

   • -2 يجب عدم إرسال هذا التغيير

8. انقر على رد (REPLY) لإرسال تعليقاتك ونتيجتك إلى مطوّر التغيير.

إذا كانت هناك مشاكل يجب إصلاحها، يُصلِحها المطوّر ويطلب منك مراجعة الإصلاحات. وإلا، تكون قد انتهيت من مراجعة التغيير.