مراجعة تغيير

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

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

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

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

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

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

  3. انقر على ملف لمراجعة التغييرات فيه. يفتح الملف في شاشة مقارنة من جزأين مع الملف الحالي على اليسار والملف الذي يحتوي على التغييرات المقترحة على اليمين. لمراجعة الملف:

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

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

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

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

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

  6. عند الانتهاء من مراجعة جميع الملفات التي طرأ عليها التغيير، ارجع إلى شاشة "تغيير المعلومات" وانقر على ردّ. تظهر شاشة تصويتات متطلبات الإرسال.

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

    • يبدو إجراء 1+ جيدًا بالنسبة لي، ولكن يجب أن يوافق عليه شخص آخر أيضًا.
    • 0 لم يتم العثور على أي نتيجة

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

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

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

إذا كان هناك مشكلات يجب إصلاحها، فسيصلحها مطوّر البرامج ويطلب منك مراجعة الإصلاحات. وإلا، فأنت بذلك تنتهي من مراجعة التغيير.