Difference between revisions of "He:מעקב תקלים"

From Gramps
Jump to: navigation, search
(expansion)
(Translation)
 
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{languages/he|How to report bugs}}
 
{{languages/he|How to report bugs}}
 
<div dir="rtl" lang="he" class="mw-content-rtl">
 
<div dir="rtl" lang="he" class="mw-content-rtl">
גרמפס מנהל מעקב אחר תקלים ובקשות שתוספות שיפורי תכונות תכנה באמצעות מערכת [https://en.wikipedia.org/wiki/Mantis_Bug_Tracker|מנטיס]. מנטיס (Mantis Bug Tracker) הוא מערכת חינמית, כתובה בקוד פתוח, שנועדה לאפשר ניהול ומעקב תקלים מקוון ושיתופי. השימוש הנפוץ ביותר במנטיס הוא אכן מעקב אחר ליקויי תכנה. עם זאת, מנטיס משמש לעיתים קרובות כמערכת מעקב אחר בעיות כלליות וככלי לניהול פרויקטים.
+
גרמפס מנהל מעקב אחר תקלים ובקשות לתוספות ושיפורי תכנה באמצעות מערכת [https://en.wikipedia.org/wiki/Mantis_Bug_Tracker| מנטיס]. מנטיס (Mantis Bug Tracker) הוא מערכת חינמית, כתובה בקוד פתוח, שנועדה לאפשר ניהול ומעקב תקלים מקוון ושיתופי.<br/ > השימוש הנפוץ ביותר במנטיס הוא אכן מעקב אחר ליקויי תכנה. עם זאת, מנטיס משמש לעיתים קרובות כמערכת מעקב אחר בעיות כלליות וככלי לניהול פרויקטים.<br />
 
את אתר מעקב אחר סוגיות/תקלים בגרמפס ניתן למצוא בכתובת הבאה: https://www.gramps-project.org/bugs
 
את אתר מעקב אחר סוגיות/תקלים בגרמפס ניתן למצוא בכתובת הבאה: https://www.gramps-project.org/bugs
מערכת מעקב אחר סוגיות/תקלים זו מאפשרת למשתמשים ומפתחים לדווח על סוגיות חדשות ולעקוב אחר מהלך התקדמותן. נא הקדישו מספר דקות לעיון בהוראות המעקב אחר סוגיות מטה ולקרוא גם את '''[[דוח_תקלים_טוב|כיצד ליצור דוח תקלים טוב]]'''. כמו כן, לעיין ב '''[[סוגיות_ידועות|סוגיות ידועות:He]]''' וב- '''[[סוגיות_נפוצות|סוגיות נפוצות]]'''.
+
מערכת מעקב אחר סוגיות/תקלים זו מאפשרת למשתמשים ומפתחים לדווח על סוגיות חדשות ולעקוב אחר מהלך התקדמותן.<br />
 +
נא הקדישו מספר דקות לעיון בהוראות המעקב אחר סוגיות מטה ולקרוא גם את '''[[He:דוח_תקלים_טוב|כיצד ליצור דוח תקלים טוב]]'''. כמו כן, לעיין ב '''[[He:סוגיות_ידועות|סוגיות ידועות]]''' וב- '''[[He:סוגיות_נפוצות|סוגיות נפוצות]]'''.
 
== המלצות ==
 
== המלצות ==
 
* היו מדוייקים
 
* היו מדוייקים
 
* היו ברורים: הסבירו בבהירות כיצד ניתן לשחזר את התקלה, צעד אחר צעד, כך שאחרים יוכלו לשחזר אותה גם, או להבין את הבקשה.
 
* היו ברורים: הסבירו בבהירות כיצד ניתן לשחזר את התקלה, צעד אחר צעד, כך שאחרים יוכלו לשחזר אותה גם, או להבין את הבקשה.
* נא לא לכלול יותר מסוגיה אחת בכל דיווח
+
* נא לא לכלול יותר מסוגיה אחת בכל דיווח.
* צרפו דוגמאות ו/או קישורים הנוגעים לסןגייה
+
* צרפו דוגמאות ו/או קישורים הנוגעים לסוגייה.
 
+
{{-}}
 
==דיווח על תקלה==
 
==דיווח על תקלה==
 
===1. התחברות===
 
===1. התחברות===
 
על מנת לדווח על תקל או להעלות בקשת שינויים ותוספות תכנה, נדרש תחילה לייצור חשבון כניסה למעקב התקלים של גרמפס:
 
על מנת לדווח על תקל או להעלות בקשת שינויים ותוספות תכנה, נדרש תחילה לייצור חשבון כניסה למעקב התקלים של גרמפס:
* {{man button|התחברו}} לחשבון בכתובת האתר https://gramps-project.org/bugs/login_page.php או;
+
* הקישו על{{man button|login}} כדי להתחבר לחשבון באתר https://gramps-project.org/bugs/login_page.php או;
* בחרו ב- {{man button|נא להירשם ליצירת חשבון חדש}}, או בקרובאתר ש בקישור הבא כדי ליצור חשבון כניסה חדש: https://gramps-project.org/bugs/signup_page.php. בעת יצירת חשבון משתמש חדש, נא לקחת בחשבון שעשויות לחלוף עד 12 שעות לפני שתשלח הודעת דוא"ל עם קישור לחשבון. רק לאחר לחיצה על הקישור שהתקבל בדוא"ל החוזר, ניתן יהיה להכנס לחשבון ולדווח על תקלים. כתובת הדוא"ל שלכם תטופל בסודיות.
+
* בחרו ב- {{man button|Signup for a new account}}, או בקרו באתר ש בקישור הבא כדי ליצור חשבון כניסה חדש: https://gramps-project.org/bugs/signup_page.php. בעת יצירת חשבון משתמש חדש, נא לקחת בחשבון שעשויות לחלוף עד 12 שעות לפני שתשלח הודעת דוא"ל עם קישור לחשבון. רק לאחר לחיצה על הקישור שהתקבל בדוא"ל החוזר, ניתן יהיה להכנס לחשבון ולדווח על תקלים. כתובת הדוא"ל שלכם תטופל בסודיות.
  
 
{{-}}
 
{{-}}
  
 
===2. חיפוש תקלים קיימים===
 
===2. חיפוש תקלים קיימים===
[[File:Search box for existing bugs.png|thumb|left|450px|Search Box]]
+
[[File:Search box for existing bugs.png|thumb|left|450px|תיבת חיפוש]]
Perhaps the bug you want to report has been submitted before. To check this, click on [https://gramps-project.org/bugs/view_all_bug_page.php {{man button|View Issues}}]. The top of the page is reserved for filters, which you set. Normally the default filters are just fine. Under these filters, there is a {{man label|Search}} box. Enter the terms best describing the bug, and click {{man button|Apply Filter}} to search. If you have an error message, try pasting a part of the error, to see if it is has been reported already.
+
יתכן מאוד שתקל זהה או דומה דווח כבר בעבר על ידי משתמשים אחרים. כדי לבדוק זאת, נא להקיש על [https://gramps-project.org/bugs/view_all_bug_page.php {{man button|View Issues}}]. החלק העליון של העמוד שמור למסננים אותם ניתן להגדיר לחיפושים עתידיים, אך לרוב מסנני ברירת המחדל שברשימה, יספקו מענה טוב. בתיבה {{man label|Search}} שמתחת למסננים אלה, יש  להזין את המונחים המתארים בצורה הטובה ביותר את התקל אותו מחפשים, ואז הקשה על {{man button|Apply Filter}} כדי להחיל את המסנן ולחפש. במידה ומתקבלת הודעת שגיאה, הדביקו חלק מהודעת השגיאה בתיבת החיפוש כדי ללבדוק אם היא כבר דווחה.
 +
אם התקל דווח כבר בעבר, נא לקרוא את דוח התקל הקיים ולבדוק אם הוא מכיל מידע נוסף שעשי לסייע בפתרון הבעיה. במידה ומידע כזה אכן קיים, כדי להשאיר הודעה עם המידע הנוסף שיעזור למפתחים לעזור לכולנו.
  
If the bug is already reported, read over the bug report, and see if you can add to the information. If so, you can leave a note with extra information to help the developers.
 
 
{{-}}
 
{{-}}
  
 
===3. דווח על תקל חדש===
 
===3. דווח על תקל חדש===
[[File:Report issue buttons Gramps bugs.png|thumb|left|450px|'Report Issue' buttons.]]
+
[[File:Report issue buttons Gramps bugs.png|thumb|left|450px|'לחצן 'דווח על סוגיה.]]
Click on one of the {{man label|Report Issue}} buttons, and enter the required information, see below on how to select the project to which the bug belongs. Be verbose, the developers are bad at mind reading. We shall mercilessly close the bugs which have no meaningful information at all, such as #{{bug|7126}}. Do not forget to list the Gramps version you are using. You can check this in Gramps by clicking in the Gramps program the Help menu, option About.
+
הקשה על אחד מלחצני {{man label|Report Issue}} והזנו את המידע הנדרש, ראו להלן כיצד לבחור את הפרויקט שאליו שייך התקל. היו מילוליים והסבירו בפשטות ובהירות את הסוגיה, המפתחים 'רעים' בקריאת מחשבות. צוות הפתוח יסגור ללא רחם את התקלים בהם אין מידע משמעותי כלל, כגון {{bug|7126}}#. חשוב לא לשכח להזין את גרסת גרמפס בה אתם משתמשים. ניתן לבדוק זאת בקלות  מסרגל הקלים בגרמפס, {{man label|עזרה}}, {{man label|אודות}}.
 
{{-}}
 
{{-}}
 
==== כיצד להמשיך ====
 
==== כיצד להמשיך ====
[[File:Dropdown-Choose-Project-GrampsBugtracker.png|thumb|left|450px|Choose Project - selection list]]
+
[[File:Dropdown-Choose-Project-GrampsBugtracker.png|thumb|left|450px|רשימת בחירה -בחירת פרוייקט ]]
The first step in submitting an issue on the tracker is to determine which project it belongs to on the issue tracker from the '''Select Project''' box, use the '''Choose Project''' drop down list to select the "project" for the bugs. "Projects" are a way to categorize issues. There are two types of projects in the issue tracker, '''Feature Requests''' and '''Gramps''':
+
השלב הראשון בדיווח סוגיה הוא לקבוע לאיזה פרויקט לשייך אותה. מתיבת הגלילה '''בחירת פרויקט''', יש לבחור את ה"פרויקט" עבור התקלה. השימוש ב"פרויקטים" נועד לסווג נושאים. ישנם שני סוגים של פרויקטים באתר מעקב התקלים, '''בקשות לתוספות ושינויים''' ו'''גראמפס''':
  
*The '''Feature Requests''' project is a place for recording requests for new features.  
+
* פרויקט '''בקשות לתוספות ושינויים''' משמש כמאגר להזנת ותיעוד בקשות לתכונות חדשות.
**If the issue represents functionality that does not currently exist in Gramps, then the issue should be filed under the '''Feature Requests''' project.
+
** אם הסוגיה מייצגת יכולות שאינן קיימות כיום בגרמפס, יש לסווג את הסוגיה במסגרת פרויקט '''בקשות לתוספות ושינויים'''.
  
*The '''Gramps''' project is a place for recording all issues with Gramps.  
+
* פרויקט '''גרמפס''' משמש כמאגר להזנת ותיעוד סוגיות קיימות בגרמפס.
**If the issue represents a problem with functionality that has been released in a stable release of code, then the issue should be filed under the project that corresponds to the maintenance branch for that release. For example, a bug found in Gramps 5.1.0 should be filed under the '''Gramps 5.1.0''' project.
+
** אם הסוגיה מייצגת בעיית פונקציונליות ששוחררה במהדורת קוד יציבה, יש לדווח על הבעיה במסגרת הפרויקט המתאים לענף התחזוקה עבור אותו שחרור. לדוגמה, יש לדווח על תקל שנמצא ב- גרמפס 5.1.0 בפרויקט '''גרמפס 5.1.0 '''.
  
*If the issue represents a problem with functionality that only exists in the master branch, or the problem exists in the master branch, but not any stable releases, then the issue should be filed under the '''Gramps Master''' project.
+
* אם הסוגיה מייצגת בעיית פונקציונליות שקיימת רק בענף הראשי (master), או שהבעיה קיימת בענף הראשי, אך לא בשחרורים יציבים כלשהם, יש לדווח על הבעיה במסגרת הפרויקט ''Gramps Master'''.
 
{{-}}
 
{{-}}
  
 
==== הזנת פרטי הסוגייה ====
 
==== הזנת פרטי הסוגייה ====
[[File:Enter Issue Details page Gramps bugs.png|thumb|left|550px|Enter Issue Details - page]]
+
[[File:Enter Issue Details page Gramps bugs.png|thumb|left|450px|עמוד הזנת סוגיה]]
The {{man label|Enter Issue Details}} page is where you share with the developers what your issue or feature request is.
+
העמוד {{man label|Enter Issue Details}} הוא המקום לשתף עם צוות הפתוח סוגיות או בקשת לתוספות ושיפורים בתכנה.
  
Try and complete all the relevant sections as well as you can and be prepared to answer follow up questions if your report needs clarification, it may help you to read the '''[[How to create a good bug report]]''' article.
+
נא לנסות ולהשלים את כל הסעיפים הרלוונטיים ככל שניתן ולהיות מוכנים לענות על שאלות בהמשך במידה ונדרש בירור או הבהרה לסוגיה, המאמר בעמוד '''[[He:דוח_תקלים_טוב|כיצד ליצור דוח תקלים טוב]]'''.
  
 
===== מילוי הטופס =====
 
===== מילוי הטופס =====
  
* Product Version
+
* גרסת המוצר
**The projects with names that look like '''Gramps x.x.X''' are where issues are reported that apply specifically to a maintenance branch (see [[Brief_introduction_to_Git#Types_of_branches|Types of Branches]]). A separate project exists for each maintenance branch.
+
** הפרויקטים עם שמות כמו '''גרמפס x.x.X''' הם המקום לדווח בו על סוגיות החלות במיוחד על ענף תחזוקה (ראו [[He:מבוא_לגיט#סוגי_ענפים|סוגי ענפים]]). לכל ענף תחזוקה קיים סוג פרויקט נפרד.
**The '''Gramps Master''' project should only be used by developers and testers of the latest code. It is a place for recording issues that only apply to the master branch in Git (see [[Brief_introduction_to_Git#Types_of_branches|Types of Branches]]). There is only one "Gramps Master" project because there is only one master branch in the Git repository.
+
** פרויקט '''Gramps Master''' אמור לשמש רק מפתחים ובודקי תכנה לקוד  שנכתב לאחרונה. זהו המקום לתיעוד נושאים החלים רק על ענף המאסטר בגיט (ראו [[He:מבוא_לגיט#סוגי_ענפים|סוגי ענפים]]). למעשה קיים רק פרויקט "מאסטר גרמפס" אחד מאחר ובמאגר יכול להימצא רק ענף מאסטר אחד.
 
{{-}}
 
{{-}}
 
  
 
==קודי תחביר שימושיים למעקב אחר תקלים במנטיס==
 
==קודי תחביר שימושיים למעקב אחר תקלים במנטיס==
  
The following are useful [http://www.mantisbt.org/ Mantis bug tracker] syntax codes you can use:
+
להלן מספר דוגמאות תחביר קוד בהם ניתן לשימוש ב[http://www.mantisbt.org/ מעקב סוגיות מנטיס]:
* Using ''<code>#</code>'' before a bug number writes a link to the bug. eg: ''<code>#1</code>'' becomes {{bug|1}}
+
* שימוש ב- ''<code>#</code>'' לפני מספר התקל יגרום לכתיבת קישור לתקל. לדוגמה: ''<code>#1</code>'' הופך ל {{bug|1}}
* Use ''<code>@</code>'' before a user name to mention a person (note: user names with embedded spaces are not supported)
+
* שימוש ב- ''<code>@</code>'' לפני שם משתמש יאזכר את אותו משתמש (הערה: אין תמיכה בשמות משתמש המכילים רווחים)
* Using ''<code>~</code>'' before a comment number writes a link to the comment, same as : ''<code>{url}#c{comment number}</code>''. eg: ''<code>~3</code>'' becomes [https://gramps-project.org/bugs/view.php?id=1#c3]
+
* שימוש ב- ''<code>~</code>'' לפני מספר הערה יגרום לכתיבת קישור להערה, זהה ל- : ''<code>{url}#c{comment number}</code>''. לדוגמה: ''<code>~3</code>'' הופך ל- [https://gramps-project.org/bugs/view.php?id=1#c3]
  
 
=== תגי HTML מוגבלים ===
 
=== תגי HTML מוגבלים ===
Line 78: Line 78:
  
 
== פתרון תקלים (עבור מפתחים) ==
 
== פתרון תקלים (עבור מפתחים) ==
This information is for the developers following up on the submitted issues.
+
מידע וההנחיות להלן נועדו למפתחים שעוקבים אחר הסוגיות שדווחו.
 
 
The [https://gramps-project.org/bugs/roadmap_page.php roadmap page] of the bug tracker lists the bugs currently prioritized for the next releases. If you are looking for a bug to fix, this is a good place to start. Placement on the roadmap is controlled by the "Target Version" field fo the bug. Special "X.Y.99" phony releases, such as "3.4.99" and "4.0.99", list bugs that we would eventually like to fix for the "X.Y" version, but don't really know the milestone yet. Bugs that really should hold up a release
 
should be on the roadmap with a real release number, and should only be moved after giving a reason or heads up on the devel list  [http://sourceforge.net/mailarchive/message.php?msg_id=31870820]. If you fix a bug scheduled for a later
 
milestone before a previous one is out, '''please manually adjust the target release field before marking the bug resolved,''' otherwise the roadmap display will be inaccurate [http://sourceforge.net/mailarchive/message.php?msg_id=31870821].
 
  
In general, when resolving an issue, it is always a good idea to add a note with the hash of the commit that fixed the problem.
+
עמוד [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].
  
When resolving issues in a maintenance branch, one should always set the "Fixed in version" field to the version of the next release that will be made from that branch. This is done so that the issue properly appears in the ChangeLog page for that project ( https://gramps-project.org/bugs/changelog_page.php ).
+
באופן כללי, לאחר פתרון סוגיה, כדאי תמיד להוסיף הערה עם סימן {{man label|#}} מקדים למספר הקיבוע שתיקן את הבעיה.
  
Bugs in maintenance branch projects should not be marked as closed until the developer has committed the change into the corresponding maintenance branch. Additionally, it is the developers responsibility to make sure the change has been merged into the master branch.
+
כאשר מיישבים סוגיות בענף תחזוקה, תמיד צריך להגדיר בשדה "תוקן בגרסה" את מספר גירסת השחרור הבאה שיופק מאותו ענף. נועד על מנת  שהנושא יופיע כראוי בעמוד יומן השינויים (ChangeLog) של אותו פרויקט (https://gramps-project.org/bugs/changelog_page.php).
  
 +
אין לסמן תקלים בפרויקטי ענף תחזוקה כסגורים עד שהמפתח קיבע את השינוי לענף התחזוקה המתאים. בנוסף, באחריות המפתחים לוודא שהשינוי מוזג לענף הראשי.
 
==ראו גם==
 
==ראו גם==
* [[How to create a good bug report]]
+
* [[He:דוח_תקלים_טוב|כיצד ליצור דוח תקלים טוב]]
* [[Known issues]]
+
* [[He:סוגיות_ידועות|סוגיות ידועות]]
* [[Common problems]]
+
* [[He:סוגיות_שכיחות|סוגיות שכיחות]]
* Help the Gramps project [[Bug triage]].
+
* סייעו לפרוייקט גרמפס [[Bug triage]].
  
 
[[Category:He:פיתוח/כללי]]
 
[[Category:He:פיתוח/כללי]]
 
[[Category:He:פיתוח/אבטחת איכות]]
 
[[Category:He:פיתוח/אבטחת איכות]]
 +
[[Category:He:כיצד...]]

Latest revision as of 15:05, 30 May 2021

גרמפס מנהל מעקב אחר תקלים ובקשות לתוספות ושיפורי תכנה באמצעות מערכת מנטיס. מנטיס (Mantis Bug Tracker) הוא מערכת חינמית, כתובה בקוד פתוח, שנועדה לאפשר ניהול ומעקב תקלים מקוון ושיתופי.
השימוש הנפוץ ביותר במנטיס הוא אכן מעקב אחר ליקויי תכנה. עם זאת, מנטיס משמש לעיתים קרובות כמערכת מעקב אחר בעיות כלליות וככלי לניהול פרויקטים.
את אתר מעקב אחר סוגיות/תקלים בגרמפס ניתן למצוא בכתובת הבאה: https://www.gramps-project.org/bugs מערכת מעקב אחר סוגיות/תקלים זו מאפשרת למשתמשים ומפתחים לדווח על סוגיות חדשות ולעקוב אחר מהלך התקדמותן.
נא הקדישו מספר דקות לעיון בהוראות המעקב אחר סוגיות מטה ולקרוא גם את כיצד ליצור דוח תקלים טוב. כמו כן, לעיין ב סוגיות ידועות וב- סוגיות נפוצות.

המלצות

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


דיווח על תקלה

1. התחברות

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

  • הקישו עלlogin כדי להתחבר לחשבון באתר https://gramps-project.org/bugs/login_page.php או;
  • בחרו ב- Signup for a new account, או בקרו באתר ש בקישור הבא כדי ליצור חשבון כניסה חדש: https://gramps-project.org/bugs/signup_page.php. בעת יצירת חשבון משתמש חדש, נא לקחת בחשבון שעשויות לחלוף עד 12 שעות לפני שתשלח הודעת דוא"ל עם קישור לחשבון. רק לאחר לחיצה על הקישור שהתקבל בדוא"ל החוזר, ניתן יהיה להכנס לחשבון ולדווח על תקלים. כתובת הדוא"ל שלכם תטופל בסודיות.


2. חיפוש תקלים קיימים

תיבת חיפוש

יתכן מאוד שתקל זהה או דומה דווח כבר בעבר על ידי משתמשים אחרים. כדי לבדוק זאת, נא להקיש על View Issues. החלק העליון של העמוד שמור למסננים אותם ניתן להגדיר לחיפושים עתידיים, אך לרוב מסנני ברירת המחדל שברשימה, יספקו מענה טוב. בתיבה Search שמתחת למסננים אלה, יש להזין את המונחים המתארים בצורה הטובה ביותר את התקל אותו מחפשים, ואז הקשה על Apply Filter כדי להחיל את המסנן ולחפש. במידה ומתקבלת הודעת שגיאה, הדביקו חלק מהודעת השגיאה בתיבת החיפוש כדי ללבדוק אם היא כבר דווחה. אם התקל דווח כבר בעבר, נא לקרוא את דוח התקל הקיים ולבדוק אם הוא מכיל מידע נוסף שעשי לסייע בפתרון הבעיה. במידה ומידע כזה אכן קיים, כדי להשאיר הודעה עם המידע הנוסף שיעזור למפתחים לעזור לכולנו.


3. דווח על תקל חדש

'לחצן 'דווח על סוגיה.

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

כיצד להמשיך

רשימת בחירה -בחירת פרוייקט

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

  • פרויקט בקשות לתוספות ושינויים משמש כמאגר להזנת ותיעוד בקשות לתכונות חדשות.
    • אם הסוגיה מייצגת יכולות שאינן קיימות כיום בגרמפס, יש לסווג את הסוגיה במסגרת פרויקט בקשות לתוספות ושינויים.
  • פרויקט גרמפס משמש כמאגר להזנת ותיעוד סוגיות קיימות בגרמפס.
    • אם הסוגיה מייצגת בעיית פונקציונליות ששוחררה במהדורת קוד יציבה, יש לדווח על הבעיה במסגרת הפרויקט המתאים לענף התחזוקה עבור אותו שחרור. לדוגמה, יש לדווח על תקל שנמצא ב- גרמפס 5.1.0 בפרויקט גרמפס 5.1.0 .
  • אם הסוגיה מייצגת בעיית פונקציונליות שקיימת רק בענף הראשי (master), או שהבעיה קיימת בענף הראשי, אך לא בשחרורים יציבים כלשהם, יש לדווח על הבעיה במסגרת הפרויקט Gramps Master'.


הזנת פרטי הסוגייה

עמוד הזנת סוגיה

העמוד Enter Issue Details הוא המקום לשתף עם צוות הפתוח סוגיות או בקשת לתוספות ושיפורים בתכנה.

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

מילוי הטופס
  • גרסת המוצר
    • הפרויקטים עם שמות כמו גרמפס x.x.X הם המקום לדווח בו על סוגיות החלות במיוחד על ענף תחזוקה (ראו סוגי ענפים). לכל ענף תחזוקה קיים סוג פרויקט נפרד.
    • פרויקט Gramps Master אמור לשמש רק מפתחים ובודקי תכנה לקוד שנכתב לאחרונה. זהו המקום לתיעוד נושאים החלים רק על ענף המאסטר בגיט (ראו סוגי ענפים). למעשה קיים רק פרויקט "מאסטר גרמפס" אחד מאחר ובמאגר יכול להימצא רק ענף מאסטר אחד.


קודי תחביר שימושיים למעקב אחר תקלים במנטיס

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

  • שימוש ב- # לפני מספר התקל יגרום לכתיבת קישור לתקל. לדוגמה: #1 הופך ל 1
  • שימוש ב- @ לפני שם משתמש יאזכר את אותו משתמש (הערה: אין תמיכה בשמות משתמש המכילים רווחים)
  • שימוש ב- ~ לפני מספר הערה יגרום לכתיבת קישור להערה, זהה ל- : {url}#c{comment number}. לדוגמה: ~3 הופך ל- [1]

תגי HTML מוגבלים

  • ניתן להשתמש בשדות המלל בערכה מוגבלת של תגי HTML:
    • <p> </p> להגדרת פסקה.
    • <li> להגדרת רשימת פריטים יחד עם:
      • <ul> רשימול לא ממוינות.
      • <ol> רשימות ממוינות.
    • <br> להכנסת 'שורה בודדת' יחידה.
    • <pre> </pre> להוספת מלל מעוצב מראש, המוצג בגופן ברוחב קבוע, ושמירה על רווח וגם על מעברי שורות.
    • <i> </i> הצגת מלל נטוי.
    • <b> </b> הצגת מלל מודגש.
    • <u> </u> הדגשת שגיאות איות בקו תחתון.
    • <em> </em> מלל מודגש.
    • <strong> הגדרת מלל חשוב.

פתרון תקלים (עבור מפתחים)

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

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

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

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

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

ראו גם