GitHub היא פלטפורמה שיתופית
שיתוף הפעולה נמצא בראש כל מה ש- GitHub עושה. נהלנו מאגרים ביחידה הראשונה של המודול ולממדנו שהמאגרים עוזרים לך לארגן את הפרוייקט ואת הקבצים שלו. ביחידה האחרונה, למדנו על בקשות משיכה, שהיא דרך לעקוב אחר שינויים שבוצעו בפרוייקט שלך.
ביחידה זו, אנחנו לומדים על נושאים ודיונים. אלה תכונות התורמות לאופי השיתופי של הפלטפורמה הארגונית של GitHub.
בעיות
בעיות GitHub משמשות למעקב אחר רעיונות, משוב, משימות או באגים לעבודה ב- GitHub. ניתן ליצור בעיות בדרכים שונות, כך שתוכל לבחור את השיטה הנוחה ביותר עבור זרימת העבודה שלך.
הדרכה זו עוסקת ביצירת בעיה ממאגר. ניתן ליצור בעיות גם מ:
- פריט ברשימת משימות.
- הערה בפרוייקט.
- הערה בבעיה או בקשת משיכה.
- שורת קוד ספציפית.
- שאילתת כתובת URL.
יצירת בעיה מתוך מאגר
ב GitHub.com, נווט אל העמוד הראשי של המאגר.
תחת שם המאגר שלך, בחר בעיות.
בחר בעיה חדשה.
אם המאגר שלך משתמש בתבניות בעיה, לצד סוג הבעיה שברצונך לפתוח, בחר תחילת.
אם סוג הבעיה שברצונך לפתוח אינו כלול באפשרויות הזמינות, בחר באפשרות פתח בעיה ריקה. אם אינך משתמש בתבניות, דלג לשלב 5.
אם המאגר שלך משתמש בטפסי בעיות, תראה טופס מובנה למילוי במקום תבנית בעיה ריקה. טופסי הנפקה מאפשרים למתחזקים לאסוף מידע ספציפי בפורמט סטנדרטי.
בתיבה הוסף כותרת, הזן כותרת עבור הבעיה.
בשדה הוסף תיאור, הקלד תיאור של הבעיה.
אם אתה מתחזק פרוייקט, באפשרותך להקצות את הבעיה למישהו, להוסיף אותה ללוח פרוייקטים, לשייך אותה לאבני דרך או להחיל תווית.
לאחר שתסיים, בחר שלח בעיה חדשה.
השתמש בתוויות, אזכורים ותגובות כדי לנהל את שיתוף הפעולה ביעילות ולהגביר את ניראות הבעיה. תבניות בעיות עוזרות לשמור על מבנה וציפיות עקביים עבור המשתתפים.
שיחות מסוימות עשויות להתאים יותר לדיונים ב-GitHub. השתמש בדיונים של GitHub כדי לשאול שאלות ולענות עליהן, לשתף מידע, להכריז הכרזות ולנהל או להשתתף בשיחות על פרוייקט.
בסעיף הבא, נעיין בדיונים וכיצד לנצל את התכונה באופן הטוב ביותר.
דיונים
דיונים מיועדים לשיחות שאינן קשורות בהכרח לקוד - כגון שאלות ותשובות, רעיונות או משוב כללי. הם תומכים בתקשורת פתוחה ומתמשכת בתוך פורום משותף ויכולים להיות ציבוריים או פרטיים, בהתאם לנראות המאגר.
בנושא זה, תלמד:
- הפעלת דיון במאגר שלך.
- יוצר דיון חדש וקטגוריות שונות של דיונים.
בוא נצלול לתוך הפעלת דיון במאגר שלך.
הפעלת דיון במאגר שלך
בעלי מאגרים ובעלי גישת כתיבה יכולים להפעיל דיונים ב-GitHub עבור קהילה במאגרים הציבוריים והפרטיים שלהם. הניראות של דיון יורשת ניראות מהמאגר שבו הוא נוצר.
כאשר אתה מפעיל לראשונה דיונים ב- GitHub, אתה מתבקש להגדיר פרסום ברכה.
ב GitHub.com, נווט אל העמוד הראשי של המאגר.
תחת שם המאגר שלך, בחר הגדרות.
גלול מטה אל המקטע תכונות ותחת דיונים, בחר הגדרת דיונים.
תחת התחל דיון חדש, ערוך את התבנית כך שתתאים לטון ולמשאבים של הקהילה שלך.
בחר התחל דיון.
כעת אתה מוכן ליצור דיון חדש.
יצירת דיון חדש
כל משתמש מאומת שיכול להציג את המאגר יכול ליצור דיון במאגר זה. עבור דיונים ברמת הארגון, כל משתמש שיכול להציג את מאגר המקור יכול גם ליצור דיון.
ב GitHub.com, נווט אל הדף הראשי של המאגר או הארגון שבו ברצונך להתחיל דיון.
תחת שם המאגר או הארגון שלך, בחר דיונים.
בצד השמאלי של הדף, בחר דיון חדש.
בחר קטגוריית דיון על-ידי בחירה בתחילת העבודה. כל הדיונים חייבים להיות ממוקמים בקטגוריה. מתחזקי מאגרים מגדירים את הקטגוריות הללו.
כל קטגוריית דיון כוללת שם, אימוג'י ותיאור ייחודיים כדי להבהיר את מטרתה. קטגוריות עוזרות לתחזוקת ארגון האופן בו שיחות מתויקות. הם ניתנים להתאמה אישית כדי לעזור להבחין בין קטגוריות&A או שיחות פתוחות יותר. הטבלה הבאה מציגה את קטגוריות ברירת המחדל עבור דיונים ואת מטרתם.
| קטגוריה | מטרה | עיצוב |
|---|---|---|
| 📣 נוספות | עדכונים ובחדשות של מתחזקי פרוייקטים | הכרזה |
| #️ כללי | כל דבר וכל דבר רלוונטי לפרוייקט | דיון פתוח |
| 💡 רעיונות | רעיונות לשינוי או לשיפור הפרוייקט | דיון פתוח |
| ️ 🗳תשאולים | סקרים עם אפשרויות מרובות להצבעה ולדיון בקהילה | סקרים |
| 🙏 רבעון&A | שאלות שהקהילה עונה עליהן, עם תבנית שאלה/תשובה | שאלה ותשובה |
| 🙌 הצג וספר | יצירות, ניסויים או בדיקות רלוונטיות לפרוייקט | דיון פתוח |
מתחזקי מאגר יכולים להצמיד דיונים חשובים לראש הכרטיסייה דיונים לנראות טובה יותר.
תחת כותרת הזן כותרת עבור הדיון שלך, ותחת כתוב הזן את גוף הדיון.
בחר התחל דיון.
זה מכסה את האופן שבו GitHub תומך בשיתוף פעולה באמצעות נושאים ודיונים. כעת נעביר אותך לאופן שבו תוכל לנהל הודעות, להירשם כמנוי לשרשורים ולתחילת העבודה עם דפי GitHub.
סימון הערה כתשובה
בדיון בסגנון שאלות ותשובות, באפשרותך לסמן הערה כתשובה המקובלת לשאלה המקורית.
- נווט לדיון.
- אתר את ההערה העונה בצורה הטובה ביותר על השאלה המקורית.
- בחר סמן כתשובה מתחת לתגובה.
ההערה תודגש, מה שיקל על אחרים למצוא את הפתרון במהירות. אתה יכול גם לבטל את הסימון של תשובה במידת הצורך.
המרת דיון לנושא
אם דיון מוביל לעבודה שיש לעקוב אחריה, באפשרותך להמיר את הדיון לנושא.
- נווט אל הדיון שברצונך להמיר.
- בחר את התפריט
...(שלוש נקודות) בפינה השמאלית העליונה של הדיון. - בחר המר לבעיה.
- אשר את ההמרה ובחר מאגר ליצירת הגיליון החדש.
זה עוקב אחר עבודה מעשית שמקורה בשיחות קהילתיות.
הצמדת דיון
באפשרותך להצמיד דיונים חשובים לראש דף הדיונים כדי לשפר את הנראות שלהם.
- נווט אל הדיון שברצונך להצמיד.
- בחר את התפריט
...(שלוש נקודות) בפינה השמאלית העליונה של הדיון. - בחר הצמד דיון.
דיונים מוצמדים מועילים להדגשת הכרזות, שאלות חשובות או נושאים מתמשכים שהקהילה צריכה לשים לב אליהם.