פתיחת PR ותיאורו

כתבת את השינוי, הרצת בדיקות, וה-diff נראה נקי. עכשיו צריך לפתוח PR — אבל שורת כותרת אחת ריקה כמו "fix bug" משאירה את הסוקר/ת בלי שום דבר להתחיל ממנו. תיאור PR טוב לא חוזר על מה שה-diff כבר מראה — הוא מסביר את ה'למה': מה גרם לשינוי, איך לבדוק שהוא עובד, ומה הסיכון. כשלריפו יש תבנית PR קבועה, ממלאים א

תיאור טוב הוא כמו פתק שמשאירים לבייביסיטר: לא מספיק לכתוב 'תשגיח/י על הילד' — צריך להסביר למה השגרה שונה הערב ואיך לבדוק שהכול בסדר לפני השינה.

תיאור PR (PR description): הטקסט שמלווה את ה-Pull Request ומסביר לסוקר/ת את הסיבה לשינוי, איך לבדוק אותו ומה הסיכון — לא רק חזרה על מה שה-diff כבר מראה.
תבנית PR (PR template): קובץ קבוע בריפו (למשל .github/pull_request_template.md) שקובע אילו סעיפים חייבים להופיע בכל תיאור PR, כדי שכולם ימלאו את אותו מידע.
PR בסטטוס טיוטה (Draft PR): PR שנפתח במצב טיוטה — נראה לצוות ומריץ בדיקות, אבל לא מאותת ל'מוכן לסקירה מלאה' עד שמסמנים אותו Ready for review.
מוכן לסקירה (Ready for review): הפעולה שהופכת PR מטיוטה למצב שמבקש בפועל תשומת לב מלאה של סוקר/ת — הסימן שהעבודה מוכנה, לא רק גלויה.