أدلة المراجعة تُعد أدلة المراجعة دليلاً على التحقق المرفق بـ 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 يحتوي على خمسة عشر عنصراً يحظى بنفس الاهتمام مثل طلب يحتوي على ثلاثة عناصر.
ارفق ما يغير القرار:
- نسخة تجريبية كلما كان التغيير مرئياً للمستخدم
- تغطية الكود عندما يكون الفرق مهماً
- فحص الأمان على أي شيء يتعلق بمعالجة المدخلات، المصادقة، أو التبعيات
- فروقات بصرية في أعمال نظام التصميم والمكونات