כיצד לבצע את בקשת המשיכה הראשונה שלך ב- GitHub

מה זה מזלג?

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

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

מהי בקשת משיכה?

בקשות משיכה הן הדרך בה אנו תורמים לפרויקטים קבוצתיים או פרויקטים בקוד פתוח.

לדוגמא, משתמש הארי מזגר מאגר של ThanoshanMV ועושה שינויים במאגר זה. עכשיו הארי יכול להגיש בקשה למשוך ל- ThanoshanMV, אך תלוי ב- ThanoshanMV לקבל או לדחות אותה. זה כמו לומר "ThanoshanMV, האם בבקשה תמשוך את השינויים שלי?"

מה זה אומר לתרום

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

כפי שנאמר במדריך ההתחלה של חברת ה- IT של חברת 99xtechnology, אנו יכולים לתרום לפרויקט קוד פתוח בדרכים הבאות:

1. תכנון: ניתן לבנות פריסות של פרויקט כדי לשפר את שימושיותו, לשפר את הניווט והתפריט של הפרויקט על סמך תוכניות מחקר משתמשים, ליצור אמנות לסמלים או חולצות טריקו ולספק מדריכי סגנון לפרויקט.
2. כתיבה: ניתן לכתוב ולשפר את תיעוד הפרויקט או לתרגם את התיעוד, לפתוח עלון לפרויקט או לכתוב מדריכים לפרויקט ולאצור דגשים מרשימת התפוצה, או לאצור תיקיית דוגמאות המציגה את אופן השימוש בפרויקטים.
3. ארגון: ניתן לקשר גליונות משוכפלים, להציע תוויות לגיליונות חדשים, להציע לסגור גליונות ישנים פתוחים ולשאול שאלות בנושאים שנפתחו לאחרונה כדי לקדם את הדיון.
4. עזור לאחרים: ענה על שאלות בנושאים פתוחים, עיין בקוד בהגשות של אנשים אחרים והצע להדריך תורם אחר.
5. קידוד: עזור לפתור בעיות פתוחות, שאל אם תוכל לספק תכונות חדשות ולשפר את הכלים והבדיקות.

בואו נגיש את בקשת המשיכה הראשונה שלנו!

אם אינך מכיר את Git & GitHub, אנא עיין במדריך למתחילים ל- Git & GitHub.

1. מזלג את המאגר

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

2. שיבט את המאגר

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

לשכפול לחץ על כפתור השיבוט והעתק את הקישור.

פתח את המסוף והפעל את הפקודה הבאה. זה ישכפל את המאגר באופן מקומי.

$ git clone [HTTPS ADDRESS]

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

עלינו לעבור לספרייה המשובטת הזו על ידי הפעלת פקודה זו:

$ cd [NAME OF REPOSITORY]

3. צור סניף

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

שם הסניף צריך להיות קצר וזה צריך לשקף את העבודה שאנחנו עושים.

כעת צור סניף באמצעות git checkoutהפקודה:

$ git checkout -b [Branch Name]

4. ערוך שינויים והתחייב אותם

בצע שינויים מהותיים בפרויקט ושמור אותו.

ואז בצע git status, ותראה את השינויים.

הוסף את השינויים האלה לענף שיצרת זה עתה באמצעות git addהפקודה:

$ git add .

כעת בצע את השינויים האלה באמצעות git commitהפקודה:

$ git commit -m "Adding an article to week 02 of articles of the week"

5. דחפו שינויים ל- GitHub

על מנת לדחוף את השינויים ל- GitHub, עלינו לזהות את שם השלט.

$ git remote

עבור מאגר זה השם של השלט הוא "מקור".

לאחר שזיהינו את שם השלט הרחוק נוכל לדחוף את השינויים האלה בבטחה ל- GitHub.

git push origin [Branch Name]

6. צור בקשת משיכה

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

אנא ספק פרטים נדרשים לגבי מה שעשית (תוכל להפנות לבעיות באמצעות "#"). הגש כעת את בקשת המשיכה.

מזל טוב! ביצעת את בקשת המשיכה הראשונה שלך.  

אם בקשת המשיכה שלך תתקבל תקבל דוא"ל.

7. סנכרן את סניף המאסטר המזלג שלך

לפני הגשת בקשות משיכה למאגר המקורי עליך לסנכרן את המאגר למקור.

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

בצע את השלבים הבאים כדי לעדכן / לסנכרן שינויים אלה לענף המאסטר שלך:

1. ראשית, בדקו באיזה סניף אתם נמצאים.

$ git branch

זה יפרט את כל הסניפים ויציין את הענף הנוכחי או הפעיל בירוק.

2. עברו לסניף המאסטר.

$ git checkout master

3. הוסף את המאגר המקורי כמאגר במעלה הזרם.

על מנת למשוך את השינויים מהמאגר המקורי לגרסה המזלגת שלך, עליך להוסיף את המאגר המקורי של Git כמאגר במעלה הזרם.

$ git remote add upstream [HTTPS]

הנה, [HTTPS] היא כתובת ה- URL שעליך להעתיק ממאגר הבעלים.

4. הבא את המאגר.

הבא את כל השינויים מהמאגר המקורי. ההתחייבויות למאגר המקורי יאוחסנו בסניף מקומי שנקרא upstream / master.

$ git fetch upstream

5. למזג אותו.

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

$ git merge upstream/master

6. דחפו שינויים ל- GitHub

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

$ git push origin master

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

$ git remote rm [Remote Name]

8. מחק את הענף המיותר

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

$ git branch -d [Branch Name]

אתה יכול למחוק את הגרסה שלו גם ב- GitHub.

git push origin --delete [Branch Name]

סיכום

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

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

הישאר חזק, הישאר חיובי, ולעולם לא לוותר.

- רוי טי בנט, האור שבלב

מאמר זה פורסם במקור ב- Medium.

תוכלו ליצור קשר ולהתחבר אלי בטוויטר.

המשיכו לתרום לעולם הקוד הפתוח!