תרומה לפרויקטים ב-GitHub (בקשת משיכה ל-Git למתחילים)

כך שבאת על פרויקט ב-GitHub ותרצה לתרום לפרויקט זה. אבל איך? אתה לא רואה את עצמך כמפתח ומונחי בקרת מקור זרים לך. אל דאגה. התשובה היא בבקשה פול ריקווסט של Git (PR).

במדריך זה, תלמד איך לתרום לפרויקט ב- GitHub עם פול ריקווסט של Git כדי להעביר את הקוד שלך ל-מאגר GitHub (repo).

תרומה לפרויקט ב- GitHub

עכשיו, כנראה שראית לפחות פרויקט אחד ב-GitHub שבו אתה חושב שאתה יכול לעזור לתקן כמה באגים, לעדכן כמה תיעוד או להוסיף תכונה חדשה. אתה רוצה להיות מעורב אך, כמו רבים מקצוענים אחרים ב-IT, אתה לא רואה את עצמך כמפתח תוכנה.

Git ו-GitHub היו לרוב במרחק רחוק בתחום הפיתוח. אך עם יותר ויותר תשתיות המתקדמות לענן וכלים כמו תשתיות כקובץ שנוצרים, מנהלי מערכות מנסים יותר ב-GitHub.

רבים ממקצועני ה-IT לא יודעים מאיפה להתחיל. אז, במאמר זה, תלמד מאפס כיצד לתרום קוד לפרויקט קיים ב-GitHub באמצעות בקשות פול ריקווסט.

מהו פול ריקווסט?

כשיש לך קוד/תיקון שיתריע פונקציות נוספות או יספק ערך נוסף לפרויקט או למאגר קיים ב-GitHub, אתה יכול ליצור פול ריקווסט.

אף על פי שבקשת משיכה היא פעולה יחידה, התוצאה הסופית (הבאת הקוד שלך למאגר ה-GitHub של מישהו אחר) כוללת חמישה שלבים עיקריים שתלמד במדריך זה.

1. שכפול או "העתקה" של המאגר המקורי לחשבון ה-GitHub שלך

המונח "שכפול" מבלבל לעיתים עם המונח "העתקה". גיט ו-GitHub הם שני מוצרים נפרדים. "שכפול" הוא מונח של GitHub שיוצר עותק של מאגר GitHub ב-GitHub. "העתקה" הוא מונח של Git שמתייחס ליצירת מאגר Git מקומי במחשב שלך על ידי הורדת מאגר Git מרחוק.

2. שינוי הקוד במאגר השינויים האישי שלך ודחיפת הקוד למאגר GitHub

3. הגשת בקשת משיכה לבעל המאגר

4. בעל המאגר מבקש ומאשר את השינויים שלך בבקשת המשיכה

5. בעל המאגר ממזג את השינויים שלך לצורך שילובם בסניף הראשי

דרישות קדם

כדי להתקדם עם הדגמות במדריך זה, וודא שיש לך את התכניות הבאות:

• A GitHub account
• A GitHub repo to request changes to – This tutorial will use a repo called git-pull-requests.
• Git – מדריך זה ישתמש ב-Git ב-Windows בתיקיית העבודה C:\Git.
• גיט התקנה לעבודה עם חשבון ה־GitHub שלך

העתקת מאגר ה־GitHub

מאחר ואין באפשרותך לבצע שינויים ישירים במאגר GitHub של מישהו אחר, עליך ליצור קודם את שלך. כדי לעשות זאת, עליך להעתיק או ליצור עותק של המאגר תחת חשבון ה־GitHub שלך. לעשות זאת:

1. פתח את הדפדפן האינטרנט המועדף עליך, עבור אל GitHub והתחבר.

2. נווט אל מאגר ההדרכה או המאגר שברצונך לתרום אליו, כפי שאתה יכול לראות למטה.

3. בפינה הימנית העליונה, לחץ על כפתור ה־Fork. הכפתור הזה ייצור באופן אוטומטי עותק של המאגר הזה בחשבון שלך.

לאחר ההעתקה, עכשיו תראה את אותו המאגר ברשימת המאגרים שלך. בנוסף, כמו שאתה יכול לראות למטה, המאגר הזה הוא עותק מאת Adam-the-Automator\git-pull-requests.

מחוות קוד חדש לעתק האישי שלך

עכשיו שיש לך את העותק האישי של המאגר בחשבון ה־GitHub שלך, הגיע הזמן לבצע את השינויים שלך. אתה יכול לבצע שינויים בקוד במאגר GitHub באחד משני הדרכים; באופן ישיר דרך github.com או מקומית דרך Git. נכסה את שתי הדרכים.

הגבלת קוד דרך github.com

הדרך הקלה ביותר לבצע שינויים בקוד במאגר GitHub היא פשוט להשתמש בדפדפן האינטרנט. על ידי שימוש ב־github.com, אין צורך לדאוג להגדיר תוכנה כלשהי במחשב מקומי. אך, שימוש בדפדפן האינטרנט יהפוך בקרוב לכאב ראש אם תצטרך לבצע שינויים מעט מורכבים.

בהנחה שאתה עדיין צופה במאגר המשונף בדפדפן שלך:

1. לחץ על הסקריפט SampleText.ps1 במאגר המשונף שלך ולחץ על סמל העט כדי לערוך אותו.

2. בצע שינויים בקובץ ולחץ על הלחצן לשמור שינויים כפי שמוצג למטה ובאופציה להוסיף הודעת שינוי.

מאגר קידום דרך Git

אם תתכנן לבצע יותר משינוי אחד פשוט בקובץ במאגר GitHub, כדאי להשתמש ב־Git. Git מאפשר לך לשכפל את כל המאגר למחשב המקומי שלך ולעבוד על הקוד בעורך הקוד המועדף עליך.

שכפול

כדי לעבוד על קוד המאגר המשונף מקומית, תצטרך תחילה לשכפל את כל המאגר למחשב המקומי שלך באמצעות Git. כדי לעשות זאת:

בהנחה שאתה עדיין נמצא במאגר המשונף שלך ב־github.com:

1. לחץ על הלחצן קוד והעתק את כתובת ה־URL מתחת לקטע ה־HTTPS.

2. לאחר מכן, פתח קונסולת שורת פקודה במחשב שלך. המדריך הזה ישתמש ב־Windows PowerShell.

3. צור ספרייה כדי לאחסן את ה־repo שהועתק והרץ `git clone` מצביע אותו ל־URL שהועתק מהשלב הקודם.

md C:\Git
 cd C:\Git
 git clone https://github.com/adbertram/git-pull-requests.git

מאפיין ודחיפת קבצים מקומיים

לאחר שקלונסת את ה־Git repo, הגיע הזמן לשנות את הקובץ ולקבוע את השינויים ב־repo. כדי לעשות זאת:

1. פתח את העורך הקוד האהוב עליך, ערוך ושמור את הקובץ `C:\SampleText.ps1`.

2. בחלון הטרמינל, ודא שתיקיית העבודה שלך היא `C:\Git` והרץ את הפקודה הבאה. הפקודה `git add` מוסיפה את הקובץ ל־repo המקומי של Git אך אינה שומרת אותו. היא פשוט מתחילה לעקוב אחריו.

cd C:\Git
 git add SampleText.ps1

3. לאחר מכן, הקום או שמור את כל הקבצים שנעקבים ב־repo של Git עם הפקודה `git commit`. הקפידו גם לכלול הסבר על מה שהשתנה (הודעת commit) עם הפרמטר `-m`.

git commit -m "modified sampletext file"

4. עכשיו שה־repo המקומי של Git מכיל את הקובץ השונה, העלה את השינוי ל־GitHub repo עם הפקודה `git push`. עליך לקבל תיבה המבקשת ממך לספק את שם המשתמש והסיסמה של GitHub כדי לאמת את ה־repo של GitHub שלך.

git push

5. לאחר שסיפקת את שם המשתמש והסיסמה של GitHub, עליך לראות את Git מספק מידע סטטוס כמו שניתן לראות למטה. הגשת בקשת Pull

בנקודה זו, יש לך כעת העתק של ספריית ה-GitHub שברצונך לתרום אליה (בעקבות הפיצוץ) בחשבון ה-GitHub האישי שלך עם השינוי שברצונך לבקש מבעל ה-GitHub לקבל. כעת יש לשלוח בקשת משיכה כדי לבקש מבעל הספרייה לקבל את השינוי שלך.

1. נווט אל ספריית ה-GitHub שלך ב-GitHub.

2. לחץ על Pull Requests ואז על New pull request כפי שמוצג למטה.

3. בדף בקשת המשיכה, תראה שני הספריות שיבוצעו השוואה ביניהן וכל commit שברצונך למשוך לספריית ה-GitHub של בעל המאגר. לחץ על Create pull request.

4. מספק כותרת לבקשת המשיכה ולחץ על Create pull request.

בשלב זה, יופיע במאגר ה-GitHub המקורי בקשת משיכה. בנקודה זו, העבודה שלך כמורם נגמרת וזמן ההמתנה לתגובת בעל המאגר מתחיל.

סקירה וקבלת בקשת משיכה

כשתיצור בקשת משיכה, היא תופיע תחת Pull Request בתוך המאגר המקורי, כפי שמוצג למטה.

בנקודה זו, בעל המאגר יכול לספק לך הערות בהן תוכל לשתף פעולה על בקשת המשיכה. או שיכולים פשוט למשוך אותה ישר על ידי לחיצה על Merge pull request.

לאחר שהם ממשיכים בבקשת המשיכה עם הקוד המקורי, בקשת המשיכה תיכנס למצב Merged והקוד יתמזג עם המאגר המקורי!

עכשיו, תוכל לראות שאתה תורם לקובץ ששינית ושהשינויים שלך נמצאים בתוך המאגר המקורי.

סיכום

במדריך זה, למדת כל צעד על איך ליצור בקשת משיכה ב-Git. בקשות משיכה הן דרך נהדרת לשתף פעולה במאגרי GitHub.

עכשיו שאתה יודע איך לתרום לפרויקטים ב-GitHub, איזה סוג של מאגר תבחר לתרום אליו?