בעיות

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

שדות הבעיה

לכל בעיה יש קבוצה של שדות משויכים שמתארים אותה ואת המצב הנוכחי שלה. המידע הזה כולל את סוג הבעיה, את מידת החשיבות שלה מבחינת חומרה ורמת העדיפות ואת הרשומה של הפעילות בנושא הבעיה. יש שדות שתקפים לכל הבעיות. ב-Issue Tracker יש תמיכה גם בשדות מותאמים אישית שזמינים רק כשהבעיה משויכת לרכיב ספציפי. בכל בעיה חדשה יש כמה שדות חובה. השדות האלה כוללים את Component, ‏ Title, ‏ Priority ו-Type. לחלק מהרכיבים יש גם שדות בהתאמה אישית שחייבים למלא.

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

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

סוג הבעיה

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

סוג הבעיה	תיאור
באג	ההתנהגות לא תואמת למה שצפוי לקרות או לתיעוד של מה שקרה, או שהמוצר לא פועל כצפוי.
בקשה להוספת תכונה	המוצר פועל כמצופה, אבל אפשר לשפר אותו באמצעות השינויים שצוינו.
בעיה של לקוח/ה	הבעיה משפיעה על צד שלישי, וייתכן שהאדם שמדווח עליה לא יכול לשחזר אותה. יכול להיות שזו בעיה שאפשר לפתור או בעיה שצריך לקבל עליה הדרכה, אבל יכול להיות שזו באג או בקשה להוספת תכונה.
ניקוי פנימי	לבעיה אין השפעה חיצונית על התנהגות המוצר, אבל טיפול בבעיה יאפשר אינטראקציה יעילה או אינטואיטיבית יותר במהלך הפיתוח של המוצר. אפשר גם להשתמש בסוג הזה כדי לעקוב אחרי בעיות תחזוקה.
תהליך	'תהליך' היא קטגוריה 'שונות' שיש לה שימושים שונים בהתאם לפרויקט. לדוגמה, אפשר להשתמש בסוג הזה לבעיות שנוצרות על ידי ממשק API, או כדי לעקוב אחרי משימות ניהוליות.
נקודת חולשה	נקודות חולשה בפרטיות ובאבטחה כפופות ל-SLO שמוגדר בהנחיות של Google בנושא פרטיות ואבטחה.
בעיה שקשורת לפרטיות	בעיות פרטיות אחרות כפופות ל-SLO שמוגדרים בהנחיות של Google בנושא פרטיות ואבטחה.
תוכנית	אוסף של יעדים שקשורים זה לזה מבחינה נושאית (פרויקטים, תכונות, אבני דרך, אפיקים).
Project	מאמץ שמוגדר לפי מטרה, עם תאריכי התחלה וסיום מוגדרים, שמתמקד ביצירת מוצר, שירות או תוצאה ייחודיים.
תכונה	אוסף עבודות שמספק ערך ספציפי למשתמש.
Milestone	אוסף עבודות שמייצג ציון דרך חשוב בדרך להשלמת פרויקט. אפשר גם להשתמש ביעדים עסקיים כדי לייצג השקות או גרסאות.
Epic	אוסף גדול של עבודות שמטרתן להשיג מטרה משותפת.
סטורי	אוסף קטן של עבודות שמספק ערך ספציפי למשתמש.
משימה	יחידה קטנה של עבודה.

עדיפות הבעיה

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

רמת העדיפות של הבעיה	תיאור
P0	בעיה שצריך לטפל בה באופן מיידי ולגייס לכך את כל המשאבים הנדרשים. בעיה כזו גורמת להפסקה מלאה בשירות או לכך שתכונה קריטית במוצר לא זמינה לכולם, ללא פתרון ידוע.
P1	בעיה שצריך לטפל בה במהירות. בעיה כזו משפיעה באופן משמעותי על אחוז גדול של משתמשים, ואם יש פתרון עקיף, הוא חלקי או קשה מדי. ההשפעה של הבעיה היא על פונקציה ארגונית מרכזית, או שהיא פוגעת באופן יסודי בצוות אחר.
P2	בעיה שצריך לטפל בה בזמן סביר. בעיה כזו יכולה להיות כל אחת מהבעיות הבאות: 1) בעיה שסווגה כ-P0 או כ-P1 אבל יש לה פתרון זמני סביר, 2) בעיה שחשובה לאחוז גדול של משתמשים ומקושרת לתפקידים הליבה של הארגון, 3) בעיה שמונעת את העבודה של צוותים אחרים ואין לה פתרון זמני סביר. P2 רלוונטי במיוחד לבעיות שקשורות לשימוש בפעם הראשונה או לבעיות שקשורות להתקנה. זו רמת העדיפות שמוגדרת כברירת מחדל.
P3	בעיה שצריך לטפל בה כשהדבר אפשרי. בעיה כזו רלוונטית לתפקידים הליבה של הארגון או לעבודה של צוותים אחרים, אבל היא לא מעכבת את ההתקדמות או שיש לה פתרון עקיף סביר.
P4	בעיה שצריך לטפל בה בסופו של דבר. בעיה כזו לא רלוונטית לתפקידים המרכזיים של הארגון או לעבודה של צוותים אחרים, או שהיא קשורה רק לאטרקטיביות או לנוחות של המערכת.

סטטוס הבעיה

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

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

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

סמלי סטטוס

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

שינוי מהיר של הסטטוס

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

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

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

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

• אם הסטטוס של בעיה מסוימת הוא נפתרה ואתם מאמתים, ההנחיה לשינוי מהיר תהיה אימות. שינוי מהיר ישנה את הסטטוס של הבעיה לנפתרה (אומתה).

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

כרטיסי מידע על בעיות

כרטיס מרחף של בעיה מכיל מידע כמו השם, המזהה, התיאור והסטטוס הנוכחי של הבעיה. בנוסף, הוא מכיל שני לחצנים: לחצן +1 כדי לציין שהבעיה רלוונטית לכם, ולחצן CC me שמוסיף אתכם לרשימת הנמענים (אם אתם כבר נכללים ברשימת הנמענים, יופיע הכיתוב Un-CC me). לדוגמה:

כרטיסי ההודעות מופיעים כשמעבירים את העכבר מעל הפריטים הבאים:

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

עריכת בעיות

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

עריכת רמות

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

סגירת עריכות

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

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

עריכות משמעותיות

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

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

הערה: תגובות שמתווספות לבעיה וכוללות רק את הטקסט '+1' מסומנות כעריכות קלות.

עריכות קלות

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

עריכות שנחשבות משניות כוללות:

• שינויים בכותרת.
• שינויים ברשימות החמות בנושא.
• הוספת קבצים מצורפים.
• שינויים ביחסים בין בעיות (חסימה, חסימה על ידי, כפילות).
• שינויים בסטטוס שלא צוינו במפורש כעריכות משמעותיות.
• שינויים בשדות הבאים: Reporter, ‏ Type, ‏ Verifier,‏ Found In, ‏ Targeted To, ‏ Verified In, ‏ In Prod.
• שינויים בשדות מותאמים אישית שמסומנים כמשניים.

עריכות שקופצות

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

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

הגבלות גישה להנפקת תעודות

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

אדמינים של בעיות יכולים לעדכן את סטטוס ההגבלה של בעיה לאחת מארבע רמות הגישה לבעיה:

• גישה שמוגדרת כברירת מחדל – הכללים הרגילים חלים: לבעיה עם רמת הגישה שמוגדרת כברירת מחדל יש את אותם רכיבי גישה כמו לכל הבעיות האחרות ברכיב.

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

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

• חשיפה מוגבלת + Google – רק לזהויות שצוינו במפורש (הקצאה, שיתוף פעולה, אימות או CC), לגוגלרים במשרה מלאה ולחשבונות אוטומציה פנימיים תהיה גישה לצפייה בבעיה.

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