أدلة المراجعة تُعد أدلة المراجعة دليلاً على التحقق المرفق بـ pull request الذي تنتمي إليه: نسخة تجريبية يمكن فتحها، نتيجة فحص، فرق في تغطية الكود، أو تسجيل لتشغيل المتصفح.
المبدأ بسيط: يجب أن تصل الأدلة والكود الذي تصفه معاً. نتيجة الفحص في لوحة بيانات منفصلة لا يطلع عليها أحد لا تُعد دليلاً، بل مجرد واجب منزلي.
ما الذي يمكن إرفاقه؟
يتكامل Coroid مع مزودين ضمن عدة فئات:
| الفئة | مزودون |
|---|---|
| أصلية لـ Git | بيئات Actions في GitHub، تطبيقات المراجعة GitLab |
| استضافة ثابتة | Vercel، Netlify، Cloudflare Pages، AWS Amplify |
| نسخ تجريبية كاملة للتطبيقات | Render، Railway، تطبيقات المراجعة Heroku، Fly.io، Northflank، Qovery، Porter |
| توزيع تطبيقات الجوال | Expo EAS، TestFlight، اختبارات داخلية في Google Play |
| المراجعة والفحص | CodeRabbit، Qodo / وكيل PR، Greptile، Cursor Bugbot، SonarQube Cloud، Snyk، Semgrep |
| تغطية الكود والمراجعة البصرية | Codecov، Chromatic، Percy |
| الاختبارات الشاملة والمراقبة | Cypress Cloud، Checkly، Maestro، BrowserStack |
| مخصصة | ويب هوك لأدلة مخصصة |
يوجد واحد وثلاثون مزوداً في المجمل. ويب هوك الأدلة المخصصة يغطي كل ما لا يظهر في القائمة.
يحدد كل مزود أنواع الأدلة التي يمكنه إنتاجها — معاينة ويب، بناء تطبيق جوال، مراجعة AI، فحص أمان، تغطية كود، مراجعة بصرية، اختبارات شاملة وأداء — وكيفية استيعاب Coroid لها، سواء من سطح Git، أو من مخرجات CI، أو عبر استدعاء API الخاص بالمزود مباشرة.
من المحتمل أنك تمتلك معظم هذه الأدوات بالفعل.
هذا هو الهدف. عادةً ما تمتلك الفرق التي تستخدم Coroid عمليات نشر تجريبية، وأداة فحص، وتقارير تغطية كود مسبقاً. تربط أدلة المراجعة بين ما هو موجود بدلاً من استبداله.
قم بتهيئة المزودين ضمن إعدادات الاتصال الخاصة بالمؤسسة؛ وبعدها تُرفق الأدلة تلقائياً بطلبات السحب التي يفتحها Coroid.
الأدلة والحواجز
الأدلة و الحواجز مترابطتان لكنهما مختلفتان:
- الأدلة هي معلومات مرفقة لكي يأخذها الإنسان في الاعتبار.
- أما الحاجز فهو قرار يفرضه النظام.
يمكن للأدلة أن تغذي حاجزاً — فحاجز حد تغطية الكود يقرأ أدلة التغطية — لكن معظم الأدلة مجرد معلومات. ليس كل ما يستحق المشاهدة يستحق أن يكون سبباً للحظر.
أدلة ما بعد الدمج
تصف أدلة المراجعة pull request. إصدار يقوم بتقييم الالتزام المحدد المُراد نشره في بيئة معينة، عبر تشغيل منفصل لـ Quality Graph وقائمة تدقيق وموافقات محددة. قد يشير إلى أدلة مراجعة صالحة، لكن نجاح فحص طلب السحب لا يضمن نشر الالتزام. يتم تسجيل عملية النشر عبر ردود استدعاء من مزود الخدمة أو شهادة يدوية؛ كما تُسجل حالة النظام بعد النشر كبيانات مراقبة.
اختيار المحتوى المراد إرفاقه
المزيد من الأدلة لا يعني بالضرورة تحسنًا. كل عنصر منها ينافس على انتباه المراجع، وpull request يحتوي على خمسة عشر عنصرًا يلقى نفس اهتمام المراجع مثل العنصر الذي يحتوي على ثلاثة عناصر فقط.
ارفق ما يؤثر على قرار المراجعة:
- معاينة معاينة كلما كان التغيير مرئيًا للمستخدم — يمكنك بدء معاينة من عملية المراجعة الخاصة بالمهمة
- تغطية الكود عندما يكون الفرق في التغطية ذا أهمية
- فحص الأمان على أي جزء يتعلق بمعالجة المدخلات أو المصادقة أو التبعيات
- اختلافات بصرية على أعمال نظام التصميم والمكونات