View source for He:מעקב תקלים

{{RTLPageStart}}
{{languages/he|Using the bug tracker}}
{{man tip|מנהל התקלים/נושאים לטיפול בגרמפס|נמצא בכתובת הבאה: <code>https://www.gramps-project.org/bugs</code>}}
מנהל התקלים/הנושאים מאפשר למשתמשים ולמפתחים לדווח על נושאים חדשים ולעקוב אחר התקדמות הטיפול בהם. מומלץ להקדיש מעט זמן לקריאת ההנחיות למנהל הסוגיות להלן, ולעיין ב'''[[How to create a good bug report/he|איך ליצור דוח טקל טוב]]'''. בנוסף, כדאי לעיין גם ב''[[Known_issues/he|סוגיות ידועות]]''' וב''[[Common_problems/he|סוגיות נפוצות]]'''.

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

{{man tip|לפני יצירת דוח "תקל"...|ניסוח דוח תקל כרוך לרוב בעבודת מחקר ומאמץ כתיבה מרובים. כדי לחסוך עבודה מיותרת:

* לא מן הנמנע שמתששים אחרים כבר חוו ודווחו על תקל זהה או דומה וכי נמצא פתרון או דרך לעקיפת הסוגיה בגוף דוח התקל הקודם או בפורומים.
* אם לא נמצא משהו שדומה לסוגיה, ניתן לשאול על כך באחד הפורומים. הקהילה תסייע לפתור או לבודד את הבעיה.
* אם נעשה שימוש ב[[Previous_releases_of_Gramps|מהדורת גרמפס ישנה יותר]], יש לציין שנבדק גם עם מהדורת גרמפס {{version}} הנוכחית, ושאותה בעיה עדיין קיימת.}}


{{-}}
==דיווח על תקל==
===1. התחברות===
כדי שניתן יהיה לדווח על תקל או להעלות בקשת שינויים, שיפורים ותוספות תוכנה, נדרש תחילה לייצור חשבון כניסה למערכת מעקב התקלים של גרמפס:
* אל מערכת המעקב התקלים ניתן להגיע דרך הקישור: https://gramps-project.org/bugs/login_page.php  ולהקיש על לחצן {{man button|login}} כדי להתחבר לחשבון קיים.  או ;
* לבחור ב־{{man button|Signup for a new account}}, או לבקר באתר שבקישור הבא כדי ליצור חשבון כניסה חדש: https://gramps-project.org/bugs/signup_page.php. לאחר יצירת חשבון משתמש חדש. בשל פעילות מוגברת של רובוטי־ספאם, בקשות לפתיחת חשבון חדש עשויות לדרוש אישור מוקדם של משתמש. יש לקחת בחשבון שעשויות לחלוף עד 12 שעות לפני שתשלח הודעת דוא"ל עם קישור לחשבון. רק לאחר לחיצה על הקישור שהתקבל בדוא"ל החוזר, ניתן יהיה להכנס לחשבון ולדווח על תקלים. כתובת הדוא"ל ששימשה ליצירת החשבון תשאר חסויה.

{{man note| מערכת ניהול התקלים של גרמפב נשענת על תוכנת [https://mantisbt.org/ Mantis]. זוהי מערכת צד ג' שמיזם גרמפס עושה בה שימוש לניהול ומעקב תקלים. וכאמור חוסר שלמות. '''ממשק המערכת תורגם לשפה העברית באופן חלקי ביותר ובאיכות ירודה''', התרגום לוקה בחוסר אחידות במושגים, בשפה לא תקנית
כדי להמנע מחוסר נוחות זה ניתן להשתמש בשפה האנגלית.}} 

{{-}}
====כיצד לשנות את תמונת הפרופיל ב־MantisBT====

מערכת MantisBT (מנהל התקלים בקוד פתוח שמיזם גרמפס משתמש בו) משתמשת באופן אוטומטי בשירות [https://gravatar.com/ Gravatar] בהתאם לכתובת הדוא״ל הרשומה.

{{-}}

===2. חיפוש בוויקי ובדיווחי באגים קיימים===
[[File:Search box for existing bugs.png|thumb|left|450px|תיבת חיפוש]]
לעיתים ההתנהגויות של תוכנת גרמפס שנצפית על המקע עשויות להיראות מוזר, אך לא מן הנמנע שזו התנהגות תקינה לחלוטין ועל־לפי־התכנון. לכן לפני דווח על תקל, הצעד הראשון הוא לחפש בוויקי של גרמפס כדי לראות מהי ההתנהגות שמתועדת. אם לא נמצא הסבר לתופעה ועדיין אין ודאות לגביה, ניתן לשאול  [https://forum.gramps-project.org/ בקהילת גרמפס ב־Discourse.]

אם עדיין נראה שמדובר בבאג, לפני פתיחת דווח חדש על תקל, כדאי מאוד ואף נדרש לחפש במערכת מעקב תקלים קיום תקל זהה או דומה, ייתכן שתקל כזה או דומה כבר דווח בעבר. כדי לבדוק זאת, יש ללחוץ על [https://gramps-project.org/bugs/view_all_bug_page.php {{man button|הצגת תקלים}}]. החלק העליון של העמוד שמור למסננים, שניתן להגדיר. לרוב מסנני ברירת־המחדל מתאימים. מתחת למסננים יש תיבת {{man label|חיפוש}}. יש להזין את המונחים שמתארים בצורה הטובה ביותר את התקל, וללחוץ על {{man button|החלת מסנן}} כדי לחפש. אם יש הודעת שגיאה, כדאי לנסות להדביק חלק ממנה, כדי לבדוק אם היא כבר דווחה.

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

===3. יצירת דווח תקל חדש===

[[File:Report issue buttons Gramps bugs.png|thumb|left|450px|'לחצן 'דווח על סוגיה.]]
ליצרית דוח חדש יש להקיש על אחד מלחצניי {{man label|Report Issue}} ולהזין בטופס שיפתח את המידע שנדרש, להלן יוסבר כיצד לבחור את המייזם שאליו שייך התקל. יש לתאר ולהסביר באופן מילולי, בפשטות ובהירות את הסוגיה, המפתחים ממש 'רעים' בקריאת מחשבות. צוות הפתוח יסגור ללא רחם את התקלים בהם אין מידע מספק משמעותי כלל, כגון {{bug|7126}}#. חשוב לא לשכח להזין את גרסת גרמפס בה נתגלה התקל. ניתן לבדוק זאת בקלות  מסרגל הקלים בגרמפס, {{man label|עזרה}}, {{man label|אודות}}.

{{-}}
==== כיצד להמשיך ====

[[File:Dropdown-Choose-Project-GrampsBugtracker.png|thumb|left|450px|רשימת בחירה – בחירת מייזם ]]

השלב הראשון בהגשת סוגיה במערכת המעקב הוא לקבוע לאיזה מיזם יש לשייך אותה. מתיבת '''Select Project''' יש לבחור את המיזם המתאים, ובאמצעות הרשימה הנפתחת '''Choose Project''' לבחור את ה״מיזם״ עבור התקל או בקשת התכונה. ״מיזמים״ משמשים לסיווג סוגיות. במערכת המעקב קיימים שני סוגי מיזמים: '''Feature Requests''' ו־'''Gramps'''.

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

* מיזם '''Gramps''' משמש לתיעוד כל הסוגיות שקשורות לגרמפס.
** אם הסוגיה מייצגת בעיה בפונקציונליות ששוחררה במהדורה יציבה, או בעיה בפונקציונליות שקיימת רק בענף הראשי (<span dir="ltr">master</span>), יש להגיש את הסוגיה במסגרת מיזם '''Gramps'''.

* לדיווחי תקל ולבקשות תכונה שקשורים ל״מרשתת גרמפס״, ניתן לעיין ב־[https://www.grampsweb.org/help/ | Get Help - Gramps Web]
{{-}}

==== הזנת פרטי סוגיה ====
[[File:Enter Issue Details page Gramps bugs.png|thumb|left|550px|הזנת פרטי סוגיה – עמוד]]
עמוד {{man label|Enter Issue Details}} הוא המקום לשיתוף המפתחים בפרטי הסוגיה או בבקשת התכונה.

דוח סוגיה/תקל מונגש למשתמשים בצורת טופס עם שדות למילוי. מקצת מהשדות הם שדות '''חובה''' שמסומנים בכוכבית אדומה ליד שם השדה.
בסוגיה חלק מהשדות הם שדות בחירה, כלומר מאפשרים בחירת ערכים מתוך רשימת ערכים, שדות אחרים הם שדות מלל חופשי בהם ניתן להזין מלל לפי העניין. בשדות מסוימים ניתן גם להוסיף צרופות כגון קבצים וצילומי מסך.
יש להשלים ככל האפשר את כל הסעיפים הרלוונטיים בטופס, ולהיות ערוכים לענות על שאלות הבהרה במשך ככל שהדיווח דורש הבהרה. 
להלן מדריך תמציתי: '''[[How to create a good bug report/he|כיצד ליצור דוח תקל טוב]]''' לגרמפס, שיגדיל מאוד את הסיכוי לשחזור הסוגיה על ידי מפתחים ולכן גם לתיקונה.

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

* בחירת פרופיל
** גרמפס פועל על כמה מערכות הפעלה, ולכן חשוב לציין על איזו מערכת הפעלה ומהדורה מדובר בדיווח. כאן נמסר מידע זה. MantisBT מאפשר לאחסן כמה פרופילים בחשבון, כך שניתן לבחור את הפרופיל המתאים — דבר שימושי אם גרמפס מופעל בתצורות מערכת שונות.
* מהדורת מוצר
** המיזמים ששמותיהם נראים כמו '''Gramps x.x.X''' הם המקום לדיווח על סוגיות ששייכות באופן ייעודי לענף תחזוקה (ief_introduction_to_Git#Types_of_branches|סוגי ענפים]]). קיים מיזם נפרד לכל ענף תחזוקה.
** לתיעוד סוגיות ששייכות ''רק'' לענף הראשי בGit ([[Brief_introduction_to_Git#Types_of_branches|סוגי ענפים]]), יש להשתמש במהדורה הבאה שטרם שוחררה, לדוגמה: <span dir="ltr">6.1.0</span>, כפי שמוצג ב[https://gramps-project.org/bugs/roadmap_page.php|מפת הדרכים של MantisBT].
* מהדורת תוסף
** אם מדווחים על תקל בתוסף צד־שלישי, ניתן להשתמש ב[[Gramps_{{man version}}_Wiki_Manual_-_Navigation#Using_the_Addon_Manager...|'''מנהל התוספים''']] או ב[[Gramps_{{man version}}_Wiki_Manual_-_Plugin_Manager/he|'''מנהל התקעים''']] (ואפשר גם ב[[Addon:Plugin Manager/he|מנהל התקעים המשופר – תוסף]]) כדי לאתר את מהדורת התוסף ולכלול אותה בדיווח.
{{-}}

==קודי תחביר שימושיים במערכת מעקב התקלים MantisBT==

להלן קודי תחביר שימושיים של [http://www.mantisbt.org/ מערכת מעקב התקלות MantisBT] שניתן להשתמש בהם:
* שימוש ב־''<code>#</code>'' לפני מספר תקלה יוצר קישור לתקלה. לדוגמה: ''<code>#1</code>'' הופך ל־{{bug|1}}
* שימוש ב־''<code>@</code>'' לפני שם משתמש נועד לאזכור אדם (הערה: שמות משתמש עם רווחים משובצים אינם נתמכים)
* שימוש ב־''<code>~</code>'' לפני מספר תגובה יוצר קישור לתגובה, בדומה ל־: ''<code>{url}#c{comment number}</code>''. לדוגמה: ''<code>~3</code>'' הופך ל־[https://gramps-project.org/bugs/view.php?id=1#c3]
* כדי לקשר בקשת משיכה (Pull Request) מ־GitHub במערכת מעקב התקלות, יש להשתמש ב־''<code>p:gramps:nnnn:</code>'' כאשר ''<code>nnnn</code>'' הוא מספר ה־PR. (תקף רק למאגר הראשי של גרמפס, ולא לתוספים.)
* כדי לקשר בקשת משיכה (Pull Request) מ־GitHub במערכת מעקב התקלות, עבור gramps addons-source יש להדביק את קישור ה־GitHub המלא.

===תגי HTML מוגבלים===
* ניתן להשתמש בשדה המלל בערכה [https://github.com/mantisbt/mantisbt/blob/55fb5721ea7d980557da484390db5c6003b63cd0/config_defaults_inc.php#L1979 מוגבלת] של [https://www.w3schools.com/tags/ תגי HTML]:
**<code> &lt;p&gt; &lt;/p&gt;</code> להגדרת פסקה.
**<code> &lt;li&gt;</code> להגדרת [https://www.w3schools.com/tags/tag_li.asp פריט רשימה] בשימוש עם:
***<code> &lt;ul&gt;</code> רשימות לא־ממוינות
***<code> &lt;ol&gt;</code> רשימות ממוינות
**<code> &lt;br&gt;</code> להוספת שבירת שורה יחידה.
**<code> &lt;pre&gt; &lt;/pre&gt;</code> להוספת מלל מעוצב מראש, שמוצג בגופן ברוחב קבוע, ושומר על רווחים ושבירות שורה.
**<code> &lt;i&gt;  &lt;/i&gt;</code> לרוב מציג מלל ב־''נטוי''.
**<code> &lt;b&gt; &lt;/b&gt;</code> מציג מלל '''מודגש'''
**<code> &lt;u&gt; &lt;/u&gt;</code> להוספת קו תחתון למילה שנאייתה שגויה
**<code> &lt;em&gt; &lt;/em&gt;</code> מעבד מלל כמלל מודגש־משמעות (emphasized).
**<code> &lt;strong&gt;</code> מגדיר מלל חשוב.

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

עמוד [https://gramps-project.org/bugs/roadmap_page.php מפת הדרכים] של 'מעקב התקלים' מפרט את התקלים המתועדפים כעת לשחרורים הבאים. אם אתם מחפשים תקל לתיקון, הגעתם למקום הנכון להתחיל בו. המיקום במפת הדרכים נשלט על ידי השדה "גרסת יעד" עבור התקל. בגרסאות הדמה המיוחדות אלו שמסתיימות בספרות 99 ("X.Y.99"), כמו "3.4.99" ו- "4.0.99", מופיעים תקלים שבסופו של דבר נרצה לתקן עבור גרסת "X.Y", אך עדיין לא ממש יודעים את אבן הדרך אליה שובץ התקל כתאריך יעד. תקלים שעלולים לעכב שחרור גרסה אמורים להיכלל במפת הדרכים עם מספר גרסה אמיתי, בכל אופן אין להעביר אותם לפני שניתן הסבר מספק למניע או או התראה [ברשימת הדיוור (רשימת devel) http://sourceforge.net/mailarchive/message.php?msg_id=31870820]. אם תקנתם תקל שתוכנן במקור לאבן דרך במועד מאוחר יותר  לפני שיצא  אחד קודם, '' נא להתאים ידנית את שדה שחרור היעד, לפני סימון התקל כפתור,'' אחרת מצג מפת הדרכים לא היה מדויק [http://sourceforge.net/mailarchive/message.php?msg_id=31870821].

באופן כללי, לאחר פתרון סוגיה, כדאי תמיד להוסיף הערה עם סימן {{man label|#}} מקדים למספר הקיבוע שתיקן את הבעיה.

כאשר מיישבים סוגיות בענף תחזוקה, תמיד צריך להגדיר בשדה "תוקן בגרסה" את מספר גירסת השחרור הבאה שיופק מאותו ענף. נועד על מנת  שהנושא יופיע כראוי בעמוד יומן השינויים (ChangeLog) של אותו פרויקט (https://gramps-project.org/bugs/changelog_page.php).

אין לסמן תקלים בפרויקטי ענף תחזוקה כסגורים עד שהמפתח קיבע את השינוי לענף התחזוקה המתאים. בנוסף, באחריות המפתחים לוודא שהשינוי מוזג לענף הראשי.
==למידע נוסף==
* [[He:דוח_תקלים_טוב|כיצד ליצור דוח תקלים טוב]]
* [[He:סוגיות_ידועות|סוגיות ידועות]]
* [[He:סוגיות_שכיחות|סוגיות שכיחות]]
* סיוע במייזם גרמפס [[Bug triage/he|סיווג ובירור תקלות]]


ב־<span dir="ltr">MantisBT.org</span> יש דיווחים שכוללים תיעוד שמיועד למשתמשים (''לא'' למנהלים):
* [https://www.mantisbt.org/bugs/view.php?id=5070 0005070]: נכתב תיעוד התחלה מהירה ל־<span dir="ltr">[MantisBT]</span> ‎[‎<span dir="ltr">.doc</span>, <span dir="ltr">.pdf</span>, <span dir="ltr">.swx</span>‎] במקרה שיש עניין
* [https://www.mantisbt.org/bugs/view.php?id=8939 0008939]: דגם מחזור־חיים ‎[<span dir="ltr">Visio</span>] לדיווח ב־<span dir="ltr">MantisBT</span>

{{-}}
[[Category:He:פיתוח]]
[[Category:He:אבטחת איכות]]
[[Category:He:כיצד...]]

{{RTLPageEnd}}