How to report a bug/he

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

המלצות מהירות לדיווחים

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

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

האם מישהו אחר כבר דיווח על הבעיה?
השתמשו בתיבת החיפוש במערכת דיווח הבאגים של ויקימדיה כדי לבדוק שהבאג לא דווח כבר. תוכלו לבצע גם חיפושים מתקדמים יותר באמצעות דף החיפוש המתקדם.

דיווח על באג או בקשה ליכולת חדשה
אם נתקלתם בבאג בגרסה עדכנית ואף אחד עוד לא דיווח עליו, אז: דחיפות (Priority): ניתן לדלג על שדה זה: באופן כללי, הדחיפות נקבעת על ידי המפתחים שמתכננים לעבוד על המשימה (ראו ""). בחרו פרויקט (project) שבו מצאתם את הבאג: זה יכול להיות למשל project של תוכנת הוויקי עצמה, או  של שינויי הגדרות של אתרי ויקי של ויקימדיה (ראו ""). עותקים (CC): ניתן לדלג על שדה זה: אם אתם יודעים על משתמשים מסוימים שיתעניינו בקבלת עדכונים על המשימה ניתן לציין אותם כאן.
 * 1) גשו phabricator.wikimedia.org ולחצו על "Maniphest" בתפריט הצד.
 * 2) בחרו "Create task" בפינה העליונה.
 * 3) תתבקשו להתחבר לחשבונכם (או ליצור אחד) אם טרם עשיתם זאת (ראו "").
 * 4) מלאו לפחות את השדות הבאים:
 * 5) * כותרת (Title): משפט קצר שמסביר את הבעיה (לא הצעה לפתרון).
 * 6) ** רצוי:
 * 7) ** לא רצוי:
 * 8) * באחריות של (Assigned to): ניתן לדלג על שדה זה: מפתחי התוכנה ימלאו את השדה כאשר יתכננו לעבוד על המשימה.
 * 1) * תיאור (Description): הפרטים המלאים של הבעיה, ובהם יש לספק מידע רב ככל האפשר. זה יכול לכלול:
 * 2) ** לתקלות:
 * 3) *** שלבים לשחזור (Steps to Reproduce): שלבים פשוטים וקלים למעקב שאפשר באמצעות לשחזר את הבעיה המתוארת. חשוב לציין הגדרות מיוחדות.
 * דוגמא:
 * 1) *** התוצאה בפועל (Actual Results): מה קרה אחרי ביצוע הפעולות
 * דוגמא:
 * 1) ***התוצאה הצפויה (Expected Results): מה הייתה התוכנה צריכה לעשות, אלמלא היה באג
 * לדוגמא:
 * 1) ** עבור בקשות ליכולות חדשות:
 * 2) *** תיאור של מה מטרת השינוי ותכליתו. סיפור משתמש יכול להיות דרך יעילה לשכנע בחשיבות הרעיון.
 * דוגמה:
 * 1) **ספקו כל מידע נוסף שעשוי להיות שימושי, כגון:
 * 2) ***הדפדפן, הרקע (סקין) ומערכת ההפעלה שבו נתקלתם בבאג;
 * 3) ***קישורים לשינויים בדף אחד או יותר שבהם נתקלתם בבאג; או
 * 4) ***האם הבעיה מופיעה תמיד, לעתים, או רק בדפים מסוימים או בתנאים מסוימים.
 * 5) *על מנת לצרף קובץ יומן (ודאו שהם אינם מכילים מידע פרטי או רגיש), לחצו על כפתור Upload File (בצורת ענן עם חץ) בתפריט הכלים של שדה ה-Description.
 * 1) *** תיאור של מה מטרת השינוי ותכליתו. סיפור משתמש יכול להיות דרך יעילה לשכנע בחשיבות הרעיון.
 * דוגמה:
 * 1) **ספקו כל מידע נוסף שעשוי להיות שימושי, כגון:
 * 2) ***הדפדפן, הרקע (סקין) ומערכת ההפעלה שבו נתקלתם בבאג;
 * 3) ***קישורים לשינויים בדף אחד או יותר שבהם נתקלתם בבאג; או
 * 4) ***האם הבעיה מופיעה תמיד, לעתים, או רק בדפים מסוימים או בתנאים מסוימים.
 * 5) *על מנת לצרף קובץ יומן (ודאו שהם אינם מכילים מידע פרטי או רגיש), לחצו על כפתור Upload File (בצורת ענן עם חץ) בתפריט הכלים של שדה ה-Description.
 * 1) *על מנת לצרף קובץ יומן (ודאו שהם אינם מכילים מידע פרטי או רגיש), לחצו על כפתור Upload File (בצורת ענן עם חץ) בתפריט הכלים של שדה ה-Description.
 * 1) **Projects are how developers find tasks to work on. To identify the right project(s), use the search function (in the top right) to find its description.

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

זהו זה! תודה לך על העזרה בפיתוח מדיה ויקי והפרויקטים של ויקימדיה!

Reporting a JavaScript bug
When you encounter a bug that may be related to JavaScript, do your best to identify error messages and copy them into the bug report.

It's especially important to provide all the information you have, because even the system administrators will have zero access to any error log. If you are unsure whether a feature you are using is based on JavaScript, try disabling JavaScript.

It's always helpful to include a screenshot with your report. It's often the easiest way to identify which feature you're talking about, and can often provide information which can help narrow down the error. Take care to hide any information you don't want to share, like other open browsers tabs or minimised chat windows.

ראו גם

 * "כיצד לדווח על באגים באופן יעיל" מאת סימון טטהם (באנגלית)
 * Wikipedia: Bug reports and feature requests
 * Phabricator etiquette
 * Bug management/Bug report life cycle
 * Writing a good bug report or feature request
 * How to create a good first Bug Report (outdated)