View source for Bug triage/he

{{RTLPageStart}}
{{languages/he|Bug triage}}
עזרה למיזם גרמפס מיון/ברירה/סיווג תקלים וסוגיות (Bug triage).

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

מערכת מעקב תקלים/סוגיות של גרמפס מנוהל באתר הבא: https://gramps-project.org/bugs

{{man note|מעונינים להתנדב?|יש לקרוא עמוד זה ואז ליצור קשר עם [https://forum.gramps-project.org/ פורום המפתחים של גרמפס] ולבקש [[#הרשאות_MantisBT|יכולת לשנות דיווחי  תקלים]]}}

==מטרות סיווג התקלים==

===מה===

מטרת סיווג תקלים היא להקל על מפתחים לבצע תיקוני תקלים ופיתוח על־ידי ארגון רשימת התקלים עבורם. משמעות הדבר הוא שמפתחים ישקיעו פחות זמן בשאלות הבהרה  למדווחי תקלים כדי להבין את הבעיה בנסין לשחזר אותה ולאשר אם היא עדיין קיימת בענף master העדכני ב־[[Brief_introduction_to_Git|Git]].

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

'''מה עושים ב־Bug Triage בפועל?'''

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

===איך===

[[File:Mantisbt-valid-status-states.png|thumb|left|450px|מצבי Status תקינים ב־MantisBT.<br>
* "'''<span style="background:#FCBDBD">new</span>'''"<br>
* "'''<span style="background:#e3b7eb">feedback</span>'''"<br>
* "'''<span style="background:orange">acknowledged</span>'''"<br>
* "'''<span style="background:yellow">confirmed</span>'''"<br>
* "'''<span style="background:#c2dfff">assigned</span>'''"<br>
* "'''<span style="background:#C9CCC4">closed</span>'''"<br>
* "'''<span style="background:Lime">resolved</span>'''"]]

====עבודת הכנה====
כשלב מקדים יש להכין סביבת בדיקות שכוללת התקנה נקייה של גרמפס וקובץ נתוני הדוגמה. יש לוודא שנעשה שימוש בגרסה העדכנית '''{{version}}''' של גרמפס; לרוב מומלץ לעבוד גם עם ענף master ב־[[Brief_introduction_to_Git|Git]]. לאחר ההתקנה יש ליצור אילן־יוחסין חדש ולייבא את קובץ נתוני הדוגמה [[example.gramps]].

כדאי לעיין ב[https://www.mantisbt.org/documentation.php תיעוד MantisBT] ולהכיר את [[Using_the_bug_tracker/he#קודי_תחביר_שימושיים_במערכת_מעקב_התקלים_MantisBT|קודי התחביר של MantisBT]] שנתמכים.

====סדר עבודת הסיווג (טריאז’)====
# '''בחירה בכרטיס''' – פתיחה ובדיקה של כרטיס שמצוי במצב "'''<span style="background:#FCBDBD">new</span>'''".
# '''איסוף מידע''' – ריכוז המידע שדרוש לשחזור: צעדי שחזור, תוצאה צפויה לעומת התוצאה בפועל, גרסת גרמפס, סוג וגרסת מערכת ההפעלה, יומנים (logs) והודעת שגיאה/traceback.
# '''ניסיון שחזור''' – ביצוע ניסיון שחזור בסביבה נקייה (עדיפות: עם [[example.gramps]] או עם מקרה מבחן מזערי).
#* אם במהלך ניסיון השחזור התגלה תקל אחר, יש לפתוח כרטיס חדש עבור התקל החדש ולציין קשר בין הכרטיסים.
# '''קביעה אם התקל שוחזר''' – החלטה אם התקל שוחזר, ובהתאם המשך טיפול:

=====אם התקל שוחזר=====
# '''בדיקות נלוות'''
## '''שיפור הכרטיס''' – כותרת מדויקת, תיאור ברור, וסדר צעדי שחזור שאפשר לבצע במדויק.
## '''תיחום התקל''' – זיהוי רכיב/פרקן/פונקציה/נסיבות שמפעילים את התקל.
## '''בדיקת תקפות''' – בחינת נחיצות הדיווח: האם הכרטיס תקף, האם הוא כפילות, והאם מדובר בגרסה נתמכת.
# '''סיווג וארגון הכרטיס''' – בדיקה אם המידע מספק, אם המיזם מתאים, ואם מדובר בתקל או בבקשת תכונה/שיפור.
# '''עדכון מצב (Status)'''
## "'''<span style="background:orange">acknowledged</span>'''" – הדיווח אינו ספאם ויש בו בסיס לפתיחת בדיקה.
## "'''<span style="background:yellow">confirmed</span>'''" – התקל שוחזר או אומת בידי אחרים.
## "'''<span style="background:#c2dfff">assigned</span>'''" – מתבצעת עבודה פעילה על התקל (אם העבודה הופסקה, יש להסיר מצב זה).
# '''תיעוד מסייע למפתחים''' – צירוף יומנים/traceback רלוונטיים, צמצום למקרה מבחן מזערי, והפניה לניסיונות טיפול קודמים (כולל קישורים ל־PR אם קיימים).
# '''סגירה/פתרון'''
## "'''<span style="background:Lime">resolved</span>'''" – התקל תוקן (רצוי לציין SHA/commit hash).
## "'''<span style="background:#C9CCC4">closed</span>'''" – הכרטיס נסגר בצירוף נימוק (לא רלוונטי/כפילות/לא ישים/גרסה לא נתמכת).

=====אם התקל לא שוחזר=====
# אם חסר מידע מהותי, יש לקבוע מצב "'''<span style="background:#e3b7eb">feedback</span>'''" ולפנות למדווח בבקשה להשלמות והבהרות.
# אם לאחר בדיקה מסתבר שהתקל אינו קיים עוד ב־{{version}}/master או שאינו ישים, יש לסגור את הכרטיס בצירוף נימוק.

<small>
הערה: "נמצא תקל חדש" משמעו שתקל אחר התגלה במהלך ניסיון שחזור התקל המקורי; במקרה כזה יש להגיש כרטיס ייעודי לתקל החדש ולציין קשר בין הכרטיסים.
</small>
<br>

====מיזמים נתמכים וטיפול בכרטיסים בגרסאות ישנות====
נכון לעכשיו נתמכים רק המיזמים Gramps 5.2, Gramps 6.0 ו־Gramps master. לכן כרטיסים שנותרו פתוחים בגרסאות שאינן נתמכות צריכים להיסגר או להיות מועברים/מעודכנים בהתאם:
* ניתן לסמן "'''<span style="background:Lime">resolved</span>'''" באופן זמני, אם התקל כבר אינו ניתן לבחינה בגרסה נתמכת.
* אם התקל אינו ישים עוד, יש לשנות מצב ל־"'''<span style="background:#C9CCC4">closed</span>'''" ולנמק.
* אם מדובר בגרסה שהגיעה לסוף חייה (EOL), יש לבצע [[How_to_make_a_backup/he|גיבוי אילנות־יוחסין]] ולהתקין גרסה נתמכת לצורך בדיקה.
** לקריאה נוספת: [[Previous_releases_of_Gramps|גרסאות קודמות של גרמפס]]
* אם התקל עדיין קיים, יש להעביר את הכרטיס למיזם הנכון (לדוגמה: תקל לעומת בקשת תכונה).
* אם חסר מידע, יש לבקש מהמדווח "'''<span style="background:#e3b7eb">feedback</span>'''".
* אם הכרטיס כולל כמה סוגיות, יש לצמצם אותו לסוגיה אחת, ולבקש לפתוח כרטיסים נפרדים עבור השאר.
* במקרה של סוגיות אחרות, יש לבחור דרך טיפול מתאימה ולנמק.

{{man note|יש להקפיד תמיד|לנהוג בנימוס בעת מענה לדיווח תקל.}}

====עקרונות עבודה משלימים====
* במיזמים הנתמכים יש להשלים סיווג: לסגור כפילויות ("'''<span style="background:#C9CCC4">closed</span>'''"), לחדד כותרות, ולהוסיף מידע שמאפשר שחזור — במיוחד באמצעות [[example.gramps/he|קובץ נתוני הדגמה של גרמפס]] — שכן שחזור הוא נקודת המוצא לתיקון.
* במיזם בקשות תכונה חדשה (Feature Requests) ארגון דיווחים: לאחד כפילויות, לשפר כותרות, ולבקש ניסוח מפורט כאשר הבקשה אינה ברורה דיה (לנהוג בנימוס).
* לא להשאיר כרטיסים במצב "'''<span style="background:#FCBDBD">new</span>'''" לאחר שבוצעה בדיקה ראשונית.
* אם הדוח/כרטיס ממתין לקלט מהמדווח או מגורם אחר, יש לסמן "'''<span style="background:#e3b7eb">feedback</span>'''".
* אם מפתח הקצה לעצמו את הסוגיה והוגשה בקשת משיכה (Pull Request) תואמת, יש לוודא שה־PR כולל הפניה לכרטיס MantisBT, בהתאם ל[[Committing_policies/he#Create_a_pull_request|מדיניות הקיבוע (commit)]] ול[[Committing_policies/he#שילוב_עם_מעקב_התקלים|שילוב מעקב תקלים עבור Pull Request]].

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

עמוד {{man label|[https://gramps-project.org/bugs/roadmap_page.php Roadmap]}} בעמעקב התקלים מציג את התקלים שכרגע נמצאות בעדיפות לגרסאות הבאות. אם מחפשים תקל לתיקון, זה מקום טוב להתחיל. מיקום ב־Roadmap נשלט על־ידי השדה {{man label|"Target Version"}} בתקל. גרסאות מדומות מיוחדות מסוג <span dir="ltr">"X.Y.99"</span>, כגון <span dir="ltr">"3.4.99"</span> ו־<span dir="ltr">"4.0.99"</span>, מציגות תקלים שהיינו רוצים לתקן בסופו של דבר עבור גרסת <span dir="ltr">"X.Y"</span>, אך עדיין לא ידוע מועד יעד מדויק. תקלים שאמורים לעכב שחרור גרסה
אמורות להופיע ב־Roadmap תחת מספר גרסה אמיתי, ויש להזיז אותן רק לאחר מתן נימוק או הודעה מראש ברשימת המפתחים [http://sourceforge.net/mailarchive/message.php?msg_id=31870820]. אם מתקנים תקל שתוזמן ליעד מאוחר יותר לפני ששוחרר יעד מוקדם יותר, '''יש לעדכן ידנית את שדה יעד השחרור (target release) לפני סימון התקל כ־'''<span style="background:Lime">resolved</span>''',''' אחרת התצוגה ב־Roadmap לא תהיה מדויקת [http://sourceforge.net/mailarchive/message.php?msg_id=31870821].

באופן כללי, בעת פתרון סוגיה, כדאי תמיד להוסיף הערה עם “commit hash” (נקרא גם Git commit “reference” או “SHA”) של ההתחייבות (commit) שתיקנה את הבעיה.

בעת פתרון סוגיות בענף תחזוקה (maintenance branch), יש תמיד להגדיר את השדה "{{man label|Fixed in version}}" לגרסת השחרור הבאה שתיווצר מאותו ענף. כך הסוגיה תופיע באופן נכון בעמוד {{man label|[https://gramps-project.org/bugs/changelog_page.php Change Log]}} עבור אותו מיזם.

תקלים במיזמי ענפי תחזוקה לא אמורות להיות מסומנות כ־"'''<span style="background:Lime">resolved</span>'''" עד שהמפתח התחייב (committed) את השינוי לענף התחזוקה המתאים. בנוסף, באחריות המפתח לוודא שהשינוי מוזג גם לענף master.

===הרשאות MantisBT===

כאשר אין הרשאות מספיקות ב־MantisBT (היכולת לשנות מצב תקל מ־"new" ל־"feedback", "acknowledged", "confirmed", "closed" או "resolved"), אפשר לבקש  [[Contact#Official|בפורום מפתחי גרמפס]] שמישהו אחר עם הרשאות מתאימות ישנה את מצב התקל למצב הרצוי (לדוגמה: "Could someone set bug #{{bug|1}} to "'''closed'''" please?). לאחר שעושים זאת מספיק פעמים, אפשר לבקש מתן הרשאות מתאימות MantisBT באותו אזור של פורום המפתחים.

==מצב==

'''עמוד סיכום מצב תקלים:'''
* https://gramps-project.org/bugs/summary_page.php

{{man warn|לתשומת לב, בעבר נעלמו 4495 סוגיות במהלך שדרוג מסד נתונים של MantisBT|למרבה הצער, מספר סוגיות קיימות במערכת ממשיכות להפנות לסוגיות אבודות אלו.}}

==סוגיות==
עם MantisBT:
* {{bug|0012273}} "Bugtracker" יצירת פרופיל הרשאות ייעודי לאנשים שתפקידם הוא סיווג בלבד

==מידע נוסף==
* [[How to create a good bug report/he|כיצד ליצור דוח תקל טוב]]
* [[Known issues/he|סוגיות ידועות]]
* [[Common problems/he|בעיות נפוצות]]

[[Category:He:אבטחת איכות]]
[[Category:He:פיתוח]]
[[Category:He:פתרון בעיות]]
{{RTLPageEnd}}