ראיות לסקירה הן הוכחת אימות המצורפת ל-pull request שאליה הן שייכות: תצוגה מקדימה שניתן לפתוח, תוצאת סריקה, שינוי בכיסוי קוד או הפעלה של דפדפן.
העיקרון פשוט – הראיות והקוד שהן מתארות צריכים להגיע יחד. תוצאת סריקה בלוח מחוונים נפרד שאיש לא פותח אינה נחשבת לראיה; זו פשוט עבודת בית.
מה ניתן לצרף?
Coroid משתלב עם ספקים ממספר קטגוריות:
| קטגוריה | ספקים |
|---|---|
| מבוססי Git | סביבות Actions של GitHub, אפליקציות סקירה של GitLab |
| איחסון סטטי | Vercel, Netlify, Cloudflare Pages, AWS Amplify |
| תצוגות מקדימות של אפליקציות מלאות | Render, Railway, Heroku Review Apps, Fly.io, Northflank, Qovery, Porter |
| הפצת אפליקציות ניידות | Expo EAS, TestFlight, בדיקות פנימיות ב-Google Play |
| סקירה וסריקה | CodeRabbit, Qodo / סוכן PR, Greptile, Cursor Bugbot, SonarQube Cloud, Snyk, Semgrep |
| כיסוי קוד ובדיקות ויזואליות | Codecov, Chromatic, Percy |
| בדיקות E2E וניטור | Cypress Cloud, Checkly, Maestro, BrowserStack |
| מותאם אישית | Webhook ראיות מותאם אישית |
בסך הכול שלושים ואחד ספקים. Webhook הראיות המותאם אישית מכסה כל דבר שאינו מופיע ברשימה.
כל ספק מציין אילו סוגי ראיות הוא יכול לספק – תצוגה מקדימה באינטרנט, בנייה לאפליקציה ניידת, סקירת AI, סריקת אבטחה, כיסוי קוד, בדיקה ויזואלית, בדיקות E2E וביצועים – וכיצד Coroid מאחסן אותן, בין אם מהממשק של Git, מפלטי CI או על ידי קריאה ישירה מ-API של הספק.
ככל הנראה כבר יש לכם את רוב אלו.
זו בדיוק המטרה. צוותים המאמצים את Coroid כבר מחזיקים בדרך כלל בתצוגות מקדימות, סורק ודוחות כיסוי קוד. ראיות לסקירה מחברות בין הכלים הקיימים במקום להחליף אותם.
הגדירו ספקים בהגדרות החיבור של הארגון; הראיות יצורפו אז אוטומטית לבקשות משיכה ש-Coroid פותח.
ראיות ושערים
ראיות ו שערים קשורים זה לזה אך שונים:
- ראיות הן מידע המצורף כדי שבני אדם יוכלו לבחון אותו.
- שער הוא החלטה שהמערכת מכריחה לקיים.
ראיות יכולות להזין שער – שער סף כיסוי קוד קורא את הראיות של כיסוי הקוד – אך רוב הראיות הן פשוט מידע. לא כל דבר שראוי לצפייה ראוי גם לחסימה.
בחירת מה לצרף
יותר ראיות אינן טובות יותר. כל פריט מתחרה על תשומת הלב של המבקר, ו-pull request המכיל חמישה-עשר פריטים זוכה לאותה תשומת לב כמו זה המכיל שלושה בלבד.
צרפו רק את מה שמשנה את ההחלטה:
- תצוגה מקדימה בכל פעם שיש שינוי הנראה לעין המשתמש.
- כיסוי קוד כאשר השינוי בכיסוי קוד משמעותי.
- סריקת אבטחה עבור כל דבר הנוגע לטיפול בקלט, אימות או תלויות.
- הבדלים ויזואליים בעבודה על מערכת עיצוב ורכיבים.