How to report a bug/he

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

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

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

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

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

דיווח על באג או בקשה ליכולת חדשה
אם נתקלתם בבאג בגרסה עדכנית ואף אחד עוד לא דיווח עליו, אז:
 * 1) גשו phabricator.wikimedia.org ולחצו על "Maniphest" בתפריט הצד.
 * 2) בחרו "Create task" בפינה העליונה.
 * 3) תתבקשו להתחבר לחשבונכם (או ליצור אחד) אם טרם עשיתם זאת (ראו "").
 * 4) מלאו לפחות את השדות הבאים:
 * 5) * כותרת (Title): משפט קצר שמסביר את הבעיה (לא הצעה לפתרון).
 * 6) ** רצוי:
 * 7) ** לא רצוי:
 * 8) * באחריות של (Assigned to): ניתן לדלג על שדה זה: מפתחי התוכנה ימלאו את השדה כאשר יתכננו לעבוד על המשימה.
 * 9) * עותקים (CC): ניתן לדלג על שדה זה: אם אתם יודעים על משתמשים מסוימים שיתעניינו בקבלת עדכונים על המשימה ניתן לציין אותם כאן.
 * 10) * דחיפות (Priority): ניתן לדלג על שדה זה: באופן כללי, הדחיפות נקבעת על ידי המפתחים שמתכננים לעבוד על המשימה (ראו "").
 * 11) בחרו פרויקט (project) שבו מצאתם את הבאג:
 * 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.


 * זה יכול להיות למשל project של תוכנת הוויקי עצמה, או  של שינויי הגדרות של אתרי ויקי של ויקימדיה (ראו "").
 * 1) * אבטחה (Security): קבעו את השדה ל"אבטחה או באג רגיש" (Security or Sensitive bug) אם משתמשים רבים עשויים להיפגע מבעיית האבטחה שעליה אתם מדווחים. הדיווח יהיה מוסתר מהציבור עד לתיקונו.
 * 2) * תיאור (Description): הפרטים המלאים של הבעיה, ובהם יש לספק מידע רב ככל האפשר. זה יכול לכלול:
 * 3) ** לתקלות:
 * 4) *** שלבים לשחזור (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.

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

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

ראו גם

 * "כיצד לדווח על באגים באופן יעיל" מאת סימון טטהם (באנגלית)
 * 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)