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

אם אין לכם GIT ניתן להתקין GIT בקישור

כדי לבצע FORK למאגר זה, ניתן ללחוץ על כפתור ה – FORK בתחילת העמוד. פעולה זה תיצור עותק של מאגר זה בחשבון שלכם.

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

git clone "url you just copied"

כאשר הביטוי "url you just copied" (ללא סימני הגרשיים) הוא הקישור למאגר שביצעתם עליו FORK מקודם. ראו את הצעדים הקודמים כדי להשיג את הקישור.

לדוגמא:

git clone https://github.com/this-is-you/first-contributions.git

כאשר this-is-you הוא שם המשתמש שלכם ב-GitHub. כאן, אתם מעתיקים את התוכן של מאגר first-contributions ב-GitHub לתוך המחשב שלכם.

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

cd first-contributions

כעת, תצרו ענף בשימוש הפעולה git checkout:

git checkout -b <add-your-new-branch-name>

לדוגמא:

git checkout -b add-alonzo-church

(שם הענף לא חייב להכיל את המילה add בתוכו, אבל זה הגיוני להוסיף אותה מכיוון שהמטרה של הענף היא להוסיף את השם שלכם לרשימה)

כעת תפתחו את הקובץ, Contributors.md בתוכנת עריכת טקסט והוסיפו את השם שלכם אליו. אל תוסיפו את השם בתחילת הקובץ או בסופו. הוסיפו אותו באמצע. לאחר שסיימתם, שמרו את הקובץ.

אם תנווטו לתיקיית הפרויקט ותבצעו את הפעולה git status, תוכלו לראות את השינויים שביצעתם שם. הוסיפו את השינויים האלו לענף שיצרתם תוך שימוש בפקודה git add:

git add Contributors.md

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

git commit -m "Add <your-name> to Contributors list"

החליפו את הביטוי <your-name> עם השם שלכם

דחפו את השינויים תוך שימוש בפקודה git push:

git push origin <add-your-branch-name>

החליפו את <add-your-branch-name> עם השם של הענף שיצרתם מוקדם יותר

אם תלכו למאגר שלכם ב-GitHub, אתם תראו כפתור עם הכיתוב Compare & pull request. לחצו על כפתור זה.

כעת, הגישו את בקשת הדחיפה

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

כל הכבוד! כרגע סיימתם את מעגל הזרימה הסטנדרטי של Fork->Clone->Edit->PR שאתם תפגשו באופן שכיח כתורמים! חגגו את התרומה שלכם ושתפו אותה עם חברים שלכם ועוקבים שלכם בכך שתלכו ל-web app. אתם יכולים להצטרף לצוות הסלאק שלנו אם אתם צריכים עזרה או אם יש לכם שאלות. הצטרפו לקבוצת סלאק.

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

רשימה של פרוייקטים ב-web app

GitKraken	Visual Studio 2017	GitHub Desktop

אם אהבתם את הפרויקט הזה, תתנו לו כוכב GitHub אם אתם מרגישים נדיבים במיוחד, תעקבו אחרי Roshan בטוויטר, Twitter ובגיטהב GitHub