תוויות הן תכונה שימושית ב-GitHub שמאפשרת לסנן בעיות ובקשות משיכה. הם עוזרים לכם למצוא משהו כיף לעבוד עליו שמתאים לרמת הניסיון שלכם.
במאגרים שלנו, רק צוות הליבה של Blockly יכול להוסיף תוויות חדשות לבעיות, כדי לוודא שהדברים לא יגיעו למקום הלא נכון.
גודל
יש בעיות קטנות ופשוטות, ויש בעיות שייקח שבועות לפתור. התוויות האלה עוזרות לכם להבין כמה עבודה כנראה תידרש כדי לפתור את הבעיה.
- Good first issue: הבעיות האלה מתאימות לאנשים חדשים במאגר. הן צריכות להימשך פחות מחצי יום עבודה, ונדרשת היכרות מוגבלת עם בסיס הקוד. אתם יכולים להתחיל לטפל בבעיות האלה באופן מיידי, בלי לקבל אישור מהצוות.
תחום שיפוט
העבודה על מאגר נתונים שמשמש אנשים רבים יכולה להיות תהליך רגיש, וחלק מהבעיות רגישות יותר מאחרות. התוויות האלה עוזרות לכם להבין אילו בעיות פתוחות לתרומה ואילו בעיות כדאי להימנע מהן.
- דרושה עזרה: הבעיות האלה שמורות לתורמים. לרוב אלה תכונות שהצוות המרכזי חושב שיהיו שימושיות, אבל אין לו זמן להטמיע אותן. יכול להיות שצריך לדון בהם או ליישם אותם, לכן כדאי לבדוק את תווית הסטטוס כדי להבין איזו עבודה נדרשת. זה מקום טוב למצוא בו פרויקטים יצירתיים ומהנים!
- פנימי: הבעיות האלה שמורות לחברי צוות הליבה. לרוב אלה באגים רגישים או מורכבים שצריך לדון בהם באופן מיוחד. מומלץ להימנע מהם כי המצב סביבם עלול להשתנות במהירות.
- ללא: בעיות שלא סומנו באף אחת מהתוויות האלה יכולות להיפתר על ידי תורמים וחברים בצוות הליבה. אם אתם רואים בעיה לא מסומנת שנראית לכם מעניינת, אתם יכולים לטפל בה.
סטטוס
בעיות מסוימות (במיוחד בקשות לתכונות) עוברות כמה שלבים שונים לפני שאפשר לסווג אותן כ'סגורות'. התוויות האלה מציינות באיזה שלב נמצאת הבעיה, כדי שתדעו מה צריך לעשות בהמשך.
- דיון: הבעיות האלה נמצאות בשלב הדיון, כלומר עדיין יש שאלות שצריך לענות עליהן לפני ההטמעה. אם יש לך רעיונות בנושא, אפשר להוסיף תגובה. אנחנו תמיד שמחים לקבל משוב.
- הטמעה: הבעיות האלה נדונו מספיק, ולכן הן מוגדרות בצורה ברורה ועברו לשלב ההטמעה. הם בהמתנה להטמעה או שההטמעה שלהם כבר מתבצעת. אם אתם רוצים לעבוד על אחת מהבעיות האלה, קראו את כל הבעיה, כתבו תגובה שבה אתם מציינים על איזה חלק אתם רוצים לעבוד, ואז פשוט התחילו לעבוד.
- לא זה ולא זה: בעיות שלא סומנו באף אחת מהתוויות יכולות להיות בכל אחד מהמצבים. אם יש לכם דעה לגבי אופן ההטמעה של הבעיה, אתם מוזמנים להוסיף תגובה. אם אתם מעוניינים לעבוד על הבעיה, מומלץ להוסיף תגובה ולשאול אם היא מוכנה להטמעה.
סוג
בעיות שונות דורשות תגובות שונות. חלק מהשינויים דורשים עריכה של כמה שורות קוד בלבד, ואחרים דורשים הרבה עיצוב ודיונים. התוויות האלה מציינות את סוג הפעולה שצריך לבצע כדי לפתור את הבעיה.
- באג: הבעיות האלה מתעדות בעיה בבסיס הקוד. לפעמים צריך לבצע ניפוי באגים כדי לאבחן את הגורם לבעיה, אבל יש בעיות שאפשר לפתור בקלות. אם אתם אוהבים לחקור לעומק כדי להבין איך הקוד פועל, אלה בעיות מצוינות בשבילכם. אתם יכולים לעזור לנו לתקן את הבאג או לחקור את הבעיה ולכתוב הסבר ברור על שורש הבעיה.
- בקשה להוספת תכונה: הבעיות האלה מתעדות תכונה שמישהו רוצה להוסיף. אפשר להחיל את ההגדרות האלה על המאגר כולו או על פרויקט ספציפי. אם אתם אוהבים לפתח רעיונות עיצוביים ולהוסיף פונקציונליות חדשה, יכול להיות שבעיות כאלה יתאימו לכם.
- שאלה: הבעיות האלה מתעדות שאלה של מישהו לגבי בסיס הקוד. בדרך כלל, השאלות האלה מועברות לפורום למפתחים, אבל אם אתם רואים שאלה שאתם יכולים לעזור בה, אתם מוזמנים להצטרף לדיון ולענות.
קטגוריה
המאגר הזה מכיל כמה סוגים שונים של פרויקטים, עם כמה סוגים שונים של קהלי יעד. אם אתם אוהבים מדריכים או עובדים על פלאגינים, התוויות האלה יכולות לעזור לכם למצוא בעיות שמעניינות אתכם.
- Codelab: הבעיות האלה קשורות ל-Blockly codelabs, סדרה של מדריכים אינטראקטיביים.
- דוגמה: הבעיות האלה קשורות לדוגמאות של Blockly, סדרה של הדגמות עצמאיות שמציגות איך לכלול את Blockly ולהרחיב אותה.
- פלאגין: הבעיות האלה קשורות לפלאגינים של Blockly, אוסף של תוספים שמוסיפים פונקציונליות ל-Blockly.
פרויקט
אם רוצים שליטה מדויקת יותר, אפשר להשתמש בתגים גם לפרויקטים ספציפיים. בדרך כלל יוצרים אותם עבור תוספים, שלרוב יש יותר בעיות שקשורות אליהם, אבל אפשר ליצור אותם גם עבור סדנאות קוד ודוגמאות. אם יש לכם פרויקט מסוים שמעניין אתכם, התוויות האלה יכולות לעזור לכם למצוא בעיות שקשורות לפרויקט הזה.
כדי לראות אם יש תווית לפרויקט שמעניין אתכם, אפשר לעיין ברשימה המלאה של התוויות:
אחר
כמו בכל אוסף של דברים, יש כמה חריגים שכדאי להכיר. יכול להיות שהתוויות האלה לא יעזרו לכם למצוא בעיה לטפל בה, אבל הן עדיין יכולות לספק מידע.
- מיון: הבעיות האלה עדיין לא סומנו בתווית המתאימה על ידי צוות הליבה. יכול להיות שבעיות עם התווית הזו כבר כוללות תווית פשוטה אחרת כמו באג או בקשה לתכונה, אבל סביר להניח שנוסיף עוד תוויות בקרוב.
- כפילות: הבעיות האלה מתעדות בעיה, בקשה או שאלה שכבר מכוסות על ידי בעיה אחרת. התווית הזו מציינת שאסור להשיב לבעיה הזו, אלא לבעיה המקורית.