README.hb.md

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

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

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

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

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

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

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

שכפול המאגר

כעת, שכפלו את המאגר הזה למחשב שלכם. לכו לדף ה-GitHub שלכם, לחצו על כפתור השכפול ואז לחצו על הצלמית copy to clipboard.

פתחו טרמינל והריצו את הפקודה הבאה:

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

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

git checkout -b 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