README.hb.md

תרומות ראשונות

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

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

ניתן לקרוא את המאמר בשפות אחרות.

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

בצעו FORK למאגר זה

כדי לבצע 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 בתוכו, אבל זה הגיוני להוסיף אותה מכיוון שהמטרה של הענף היא להוסיף את השם שלכם לרשימה)

ערכו שינויים הכרחיים ובצעו להם commit

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

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

git add Contributors.md

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

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

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

לדחוף את השינויים ל-GitHub

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

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

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

הגישו את השינויים שלכם לסקירה

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

כעת, הגישו את בקשת הדחיפה (pull request):

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

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

מה לעשות מכאן?

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

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

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

חומר נוסף

הדרכות בשימוש כלים אחרים

GitKraken	Visual Studio 2017	GitHub Desktop