מדריך פשוט להכנת יחסי הציבור הראשונים שלך (Pull Request)

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

https://github.com/CodeLabora/TuPrimerPR

ובכן, בואו נפרט במהירות את הצעדים הדרושים למשלוח יחסי ציבור:

  1. מזלג
  2. שיבוט
  3. מרוחק
  4. סניף
  5. שינויים
  6. להוסיף
  7. לְבַצֵעַ
  8. דחוף
  9. PR

אני מכניס אותם לאנגלית כך שהם ימצאו את האפשרויות שלהם בשורת הפקודה git.

מזלג

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

שֶׁלוֹ. כריסטופר דיאז ריברוס

לאחר סיום המזלג, תראה שהמאגר מופיע בחשבונך.

שֶׁלוֹ. כריסטופר דיאז ריברוס

שיבוט

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

שֶׁלוֹ. כריסטופר דיאז ריברוס

ועם המסוף שלנו אנו עושים את הפעולות הבאות.

שֶׁלוֹ. כריסטופר דיאז ריברוס

עם זאת תהיה לנו תיקיה חדשה בשם TuPrimerPR בה פרויקט Github שלנו יהיה. אנחנו נכנסים לתיקייה עם הפקודה «cd TuPrimerPR» ונראה שבתוכם נמצאים הקבצים שנמצאים במזלג שלנו.

שֶׁלוֹ. כריסטופר דיאז ריברוס

(שימו לב שמספר הקבצים יכול להשתנות בהתאם למה שהם מוצאים במאגר שלי כשהם מתפצלים)

מרוחק

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

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

שֶׁלוֹ. כריסטופר דיאז ריברוס

זה הפרויקט המקורי (נקרא לזה בְּמַעֲלֶה הַזֶרֶם לעמוד בקצב של פרויקטים רבים).

שֶׁלוֹ. כריסטופר דיאז ריברוס

כפי שאתה יכול לראות, הוספתי את השלט עם »git add מרחוק »

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

סניף

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

שֶׁלוֹ. כריסטופר דיאז ריברוס

עכשיו שאנחנו בסניף המיוחד שלנו, אנחנו יכולים לעבוד על התרומה שלנו.

שינויים

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

שֶׁלוֹ. כריסטופר דיאז ריברוס

"מגע" מאפשר לנו ליצור קובץ ריק (אם הוא לא קיים). בעזרת זה נוכל לעבור לשלב הבא שלנו.

להוסיף

»Git add» מאפשר לנו להוסיף קבצים להתחייבות שלנו (אסביר בהמשך). כדי לראות אילו קבצים תוכלו להוסיף תוכלו להשתמש בפקודה »git status»

שֶׁלוֹ. כריסטופר דיאז ריברוס

עם זה יש לנו הכל מוכן להתחייבות שלנו

לְבַצֵעַ

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

שֶׁלוֹ. כריסטופר דיאז ריברוס

וכשמסיימים ושומרים את הטקסט, נראה משהו כמו:

שֶׁלוֹ. כריסטופר דיאז ריברוס

היכן שמוצג סיכום של מה שההתחייבות עושה.

דחוף

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

שֶׁלוֹ. כריסטופר דיאז ריברוס

שימו לב שאנחנו משתמשים בשם הסניף שלנו ושהוא מבקש מאיתנו את שם המשתמש והסיסמה שלנו. בסוף זה מראה לנו שהסניף myImprove נוצר בחשבון Github שלנו. בואו נראה מה השגנו בדפדפן. 😉

PR

שֶׁלוֹ. כריסטופר דיאז ריברוס

כפי שאתה יכול לראות, נוצרה שורה חדשה שאומרת "השווה & משיכת בקשה". פונקציונליות זו של Github מאפשרת לנו ליצור את יחסי הציבור בצורה פשוטה, אנו הולכים ללחוץ כדי לראות מה קורה.

שֶׁלוֹ. כריסטופר דיאז ריברוס

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

נוסף

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

שֶׁלוֹ. כריסטופר דיאז ריברוס

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

שֶׁלוֹ. כריסטופר דיאז ריברוס

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

אנו חוזרים לסניף המאסטר שלנו ועושים את הפעולות הבאות:

שֶׁלוֹ. כריסטופר דיאז ריברוס

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

שֶׁלוֹ. כריסטופר דיאז ריברוס

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

שֶׁלוֹ. כריסטופר דיאז ריברוס

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

מסקנה

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

לא נגעתי באלף ואחד הטבות של גיט (עַיִן, לא Github) וכפי שהיית מצפה ממפתחים שקשורים לקהילת הגרעינים, Git הוא כלי חזק ביותר, עם מאות פונקציות.

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

ברכות ואני מקווה שזה יעזור לך 😉


השאירו את התגובה שלכם

כתובת הדוא"ל שלך לא תפורסם. שדות חובה מסומנים *

*

*

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

  1.   כריסטיאן אברזואה דיג'ו

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

  2.   ChrisADR דיג'ו

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

  3.   גוסטבו דיג'ו

    מצוין

    1.    ChrisADR דיג'ו

      כמה טוב זה שירת אותך 😉 ברכות

  4.   אפריל דיג'ו

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

  5.   Ch3ssMaster דיג'ו

    מוסבר טוב מאוד, מהיסודות, תודה. הייתי משפר את הקפטות כשיהיה לך זמן.