نظرة عامة
تجمع ميزة مراجعة الكود بين pull requests وتغييرات الكود ونتائج المراجعة والتعليقات والفحوصات في مكان واحد. يمكنك مراجعة تغييرات الآخرين، أو متابعة الملاحظات على pull requests التي أنشأتها، أو طلب شرح أحد التغييرات من Codex قبل الرد.
يدعم المكوّن الإضافي لمراجعة الكود إجراء المراجعات على تطبيق سطح المكتب والويب. تتوفر مراجعة طلبات الدمج في GitLab كميزة تجريبية. مراجعات الكود السحابية لـ GitLab غير متاحة.
قبل البدء
استخدم حسابًا للمستودع يملك صلاحية الوصول إلى pull request الذي تريد مراجعته. تحدّد أذوناتك في المستودع ما يمكنك قراءته أو تغييره.
إذا كنت تستخدم مساحة عمل مشتركة خاضعة للإدارة، فيجب أن يتوفر لك المكوّن الإضافي لمراجعة الكود وأي اتصال مطلوب بالتطبيقات. لا يمنحك تثبيت مكوّن إضافي صلاحية الوصول إلى المستودع.
لمعرفة كيفية إعداد المكوّنات الإضافية وضوابط مساحة العمل المشتركة، اطّلع على المكوّنات الإضافية في ChatGPT وCodex.
العثور على pull request
افتح ميزة مراجعة الكود للعثور على pull requests التي أنشأتها أو طُلب منك مراجعتها. استخدم البحث وعوامل التصفية لتضييق نطاق القائمة، ثم اختر pull request.
تحقّق من المستودع والعنوان وصاحب التغيير والفرع للتأكد من أنك تراجع التغيير المقصود. يوضّح الوصف هدف صاحب التغيير، بينما يُظهر عرض الفروق الكود الذي تغيّر.
مراجعة التغييرات
اقرأ وصف pull request وملخّصه.
افحص الملفات المعدّلة والأسطر ذات الصلة في عرض الفروق.
راجع النتائج والتعليقات الموجودة.
تحقّق من نتائج الاختبارات والفحوصات وأي تعارضات دمج لم تُحلّ بعد.
اسأل Codex عن أي شيء يحتاج إلى مزيد من التحقق.
تحقّق من نتائج المراجعة المُولَّدة بمقارنتها بالكود ذي الصلة قبل الاعتماد عليها.
سؤال Codex عن pull request
استخدم المحادثة الخاصة بـ pull request لطرح أسئلة عن التغييرات أو التحقق من إحدى نتائج المراجعة. اذكر سلوك الكود أو معايير المراجعة التي تهمّك. على سبيل المثال:
«Explain how this change affects sign-in.»
«Check whether the new error path releases the database connection.»
«Show me the code that supports this finding.»
«Compare this revision with the review feedback and identify anything still unresolved.»
يمكنك أيضًا أن تطلب من Codex إعداد إصلاح. صِف التغيير الذي تريده وأي قيود على نطاقه، ثم افحص الفروق الناتجة ونتائج الاختبارات.
على سبيل المثال: «Address the error-handling finding. Keep the change limited to this function and add a test for the failing case.»
راجع النتيجة قبل إرسال التعليقات أو تثبيت التغييرات في المستودع أو دمجها.
مراجعة طلبات الدمج في GitLab
يتيح الدعم التجريبي لـ GitLab عرض طلبات الدمج ضمن ميزة مراجعة الكود. يمكنك فحص التغييرات والاستعانة بـ Codex لفهم ملاحظات المراجعة ومعالجتها.
استخدم اتصال GitLab الخاص بالحساب والمشاريع التي تنوي مراجعتها. لمعرفة خيارات الاتصال وأذونات المستودع، اطّلع على ربط GitLab بـ ChatGPT وCodex.
لا تشمل الميزة التجريبية داخل التطبيق مراجعات الكود السحابية لـ GitLab. لا يؤدي ربط GitLab أو ظهور طلب دمج في ميزة مراجعة الكود إلى تفعيل المراجعة السحابية التلقائية لذلك المستودع.
الأسئلة الشائعة
هل يمكنني مراجعة التغييرات المحلية قبل إنشاء pull request؟
نعم. يمكنك أن تطلب من Codex مراجعة التغييرات المحلية. اطّلع على دليل مراجعة الكود لمعرفة خيارات المراجعة المحلية.
هل ينقل هذا التحديث مراجعاتي السحابية الحالية إلى البيئات السحابية الجديدة؟
لا. لا ينقل هذا التحديث مراجعات الكود السحابية الحالية إلى البيئات السحابية الجديدة.