תוויות לבעיה

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

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

גודל

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

  • בעיה ראשונה: הבעיות האלה מעולות לאנשים חדשים במאגר. הם צריכים להימשך פחות מחצי יום עבודה, ונדרשת היכרות מוגבלת עם קוד הבסיס. תוכלו להתחיל לעבוד על הבעיות האלה מיד, בלי לקבל אישור מהצוות.

תחום שיפוט

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

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

סטטוס

בעיות מסוימות (במיוחד בקשות להוספת תכונות) עוברות כמה שלבים שונים לפני שאנחנו מגדירים אותן כ'סגורות'. התוויות האלה מציינות באיזה שלב נמצאת הבעיה כרגע, כדי שתדעו מה עליכם לעשות בשלב הבא.

  • דיון: הבעיות האלה נמצאות בשלב הדיון, כלומר יש עדיין שאלות שיש לענות עליהן לפני הטמעה. אם יש לכם רעיונות הקשורים לנושא, אתם מוזמנים להוסיף תגובה! אנחנו תמיד מחפשים משוב נוסף.
  • הטמעה: דיברנו על הבעיות האלה, עד שכל הבעיות האלה מוגדרות בבירור, ועברו לשלב ההטמעה. הם ממתינים להטמעה או שכבר מיושמים. אם אתם רוצים לעבוד על אחד מהנושאים האלה, קראו את כל המאמר וכתבו תגובה על איזה חלק אתם רוצים לעבוד. התקדמו וצוללו פנימה!
  • לא: בעיות שאין להן תוויות יכולות להיות באף אחד מהמצבים. אם יש לכם דעה בנוגע לאופן שבו יש ליישם את הבעיה, אתם מוזמנים לכתוב תגובה! לחלופין, אם אתם רוצים לטפל בבעיה, מומלץ לשלוח הערה כדי לשאול אם אפשר להטמיע אותה.

תיאור

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

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

קטגוריה

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

  • Codelab: הבעיות האלה קשורות ל-Blockly codelabs, חבילת מדריכים אינטראקטיביים.
  • דוגמה: הבעיות האלה קשורות לדוגמאות של חסימת תוכן.
  • פלאגין: הבעיות האלה קשורות ליישומי פלאגין של חסימת נתונים, אוסף של תוספים שמוסיפים את הפונקציונליות שלBlockly.

פרויקט

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

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

אחר

כמו בכל אוסף של דברים, יש גם כמה כדורים אי-זוגיים שכדאי להכיר. התוויות האלה לא בהכרח מועילות כשמחפשים בעיה, אבל הן עדיין יכולות לספק מידע.

  • Triage: הבעיות האלה עדיין לא תויגו בצורה נכונה על ידי הצוות המרכזי. יכול להיות שבעיות בתווית הזו כבר כוללות תווית פשוטה אחרת כמו באג או בקשה להוספת תכונה, אבל סביר להניח שתוויות נוספות יתווספו בקרוב.
  • כפילות: בבעיות האלה מתועדות בעיה, בקשה או שאלה שכבר טופלו על ידי בעיה אחרת. התווית הזו מציינת שאין להשיב לבעיה המקורית, אלא להשיב עליה.