בקשה למשוך (PR) היא תכונה של GitHub המאפשרת לך להציע שינויים למאגר שאין לך גישת כתיבה אליו. מנהלי המאגר יכולים לסקור את השינויים הללו, ואם יבחרו, למזג אותם לתוך המאגר המקורי.
פתיחת בקשות משיכה ב- GitHub היא חיונית בתרומה לפרויקטים בקוד פתוח ובשיתוף פעולה עם מפתחים אחרים. למד כיצד ליצור ולפתוח בקשת משיכה ב-GitHub בכמה שלבים פשוטים.
שלב 1: מזלג המאגר
מזלג מאגר על פלטפורמת GitHub יוצר עותק - המכונה גם "מזלג" - של המאגר הזה, תחת חשבונך. חישול מאגר מאפשר לך לבצע שינויים בקוד מבלי להשפיע על המאגר המקורי.
כדי לחלק מאגר, נווט אל העמוד הראשי שלו ולחץ על מזלג כפתור בפינה הימנית העליונה:
מלא את שם המאגר (מזלג) ותיאור אופציונלי ולחץ צור מזלג:
כעת יצרת עותק של המאגר המקורי. למאגר החדש הזה יש קשר עם המקור כך שניתן להשוות בקלות כל שינוי שתבצע בקוד ולמזג אותו בחזרה.
שלב 2: ביצוע שינויים בקוד
לאחר שחילקת את המאגר, ייתכן שתצטרך לשכפל אותו למחשב המקומי שלך, בהתאם לכמות ואופי השינויים שברצונך להציע. אם אתה מבצע שינויים פשוטים מאוד שאינך צריך לבדוק, אתה יכול לעשות זאת באינטרנט באמצעות
העורך מבוסס האינטרנט של GitHub.כדי לשכפל מאגר למחשב המקומי שלך באמצעות Git, הפעל את פקודת הטרמינל הזו:
git שיבוט
החלף עם כתובת האתר של המאגר שלך - אתה יכול למצוא זאת ב- GitHub. פקודה זו תשבט את המאגר למחשב המקומי שלך, שם תוכל להתנסות בחופשיות ולבצע שינויים בקוד.
אתה צריך לשמור על השינויים שלך קטנים וממוקדים, שכן בקשות משיכה גדולות יכולות להיות מאתגרות לבדיקה ולמיזוג. נסה לשמור על השינויים שלך ספציפיים לבעיה או תכונה אחת, כדי להקל על המתחזקים לבדוק ולקבל אותם.
לאחר ביצוע השינויים הרצויים לך באופן מקומי, בצע אותם ודחוף אותם למזלג GitHub שלך באמצעות Git.
שלב 3: פתיחת בקשת משיכה
לאחר שביצעתם את השינויים שלכם ב-GitHub, אתם אמורים לראות הנחיה המתריעה על כך שהסניף שלכם הוא מספר "התחייבויות" לפני המאגר שממנו חילצתם אותו, למשל:
לחץ על לתרום להפיל. לחיצה על כפתור זה תנחה אותך לפתוח בקשת משיכה. לאחר מכן, לחץ על פתח בקשת משיכה לַחְצָן:
לחלק מהמאגרים יש הנחיות ספציפיות לתרומה, שבדרך כלל תוכלו למצוא בקובץ CONTRIBUTING.md, שעליכם לפעול לפיהן. הקפד לקרוא ולעקוב אחר ההנחיות הללו לפני שאתה שולח בקשת משיכה.
לאחר מכן, מלא את השדות הנדרשים ולחץ על צור בקשת משיכה לַחְצָן:
הודעת ההתחייבות שלך צריכה להיות ברורה ותמציתית, לתאר את השינויים שביצעת ואת ההיגיון מאחוריהם. זה יעזור לתחזוקה להבין את השינויים שלך ויקל עליהם לעיין בקוד.
לאחר שיצרת את המשיכה שלך, תצטרך להמתין עד שמנהלי הפרויקט יבדקו וימזגו אותו או יסגרו אותו. למנהלים עשויים להיות הצעות או משוב על בקשת המשיכה שלך. היו פתוחים לשינויים ומוכנים לבצע שינויים אם הם יבקשו מכם.
החשיבות של בקשות משיכה
בקשות משיכה מקלות על שיתוף פעולה בין מפתחים בכך שהיא מאפשרת להם להציע שינויים, לספק משוב ולבדוק קוד. זה עוזר לטפח תחושה של קהילה ושיתוף פעולה בתוך פרויקט, מה שמוביל ליותר תרומות ופיתוח מהיר יותר.
יתרה מזאת, בקשות משיכה מארגנות את היסטוריית הפרויקט ואת ניהול הגרסאות על ידי מתן אפשרות לתחזוקה לעקוב אחר הגירסאות השונות של הקוד והשינויים שבוצעו בכל גרסה.
