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: You should ignore this field: Developers will set an assignee when they plan to work on the task.
 * 9) * CC: You should ignore this field: If you know specific users who will be interested in getting notified of this task you can add them here.
 * 10) * Priority: You should ignore this field: In general, the priority is set by developers who plan to work on the task (see Setting priorities).
 * 11) * בחרו פרויקט (project) שבו מצאתם את הבאג:
 * 12) **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.
 * 13) **This could be for example the project for the wiki software itself, or  for configuration changes on a Wikimedia site (see "").
 * 14) * אבטחה (Security): קבעו את השדה ל"אבטחה או באג רגיש" (Security or Sensitive bug) אם משתמשים רבים עשויים להיפגע מבעיית האבטחה שעליה אתם מדווחים. הדיווח יהיה מוסתר מהציבור עד לתיקונו.
 * 15) * תיאור (Description): הפרטים המלאים של הבעיה, ובהם יש לספק מידע רב ככל האפשר. זה יכול לכלול:
 * 16) ** לתקלות:
 * 17) *** שלבים לשחזור (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"). הדיווח ישמר כעת במסד הנתונים ובתקווה יטופל בהקדם.

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

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)