איך לדווח על באג

Phabricator is for software bug reports, feature requests, and planning work.

• To ask technical questions about Wikimedia projects, see m:Tech
• To ask technical questions about MediaWiki in non-WMF installations, see Project:Support desk

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

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

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

• Be clear: explain 1) how to reproduce the situation, step by step, without leaving any room for interpretation, 2) expected behavior, 3) actual behavior. In separate sections

• Include only one specific bug or one specific feature request per task

• Include any relevant links and examples

לפני דיווח

האם אתם יכולים לשחזר את הבעיה?

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

האם מישהו אחר כבר דיווח על הבעיה?

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

If you are unsure whether a bug has already been reported, you should report the bug. It is better to have duplicate bugs than it is to have unreported bugs.

Is it maybe a gadget / user script issue?

Some problems are a consequence of using user scripts and gadgets which need some fixes.

There is a guide available with steps how you can identify such code, which could fix your issue so that you do not waste your time reporting it.

Is it a caching issue?

Some issues relate to older cached HTML being served alongside newer JavaScript where the two are incompatible. To help determine if this is the cause it is helpful to purge the page, refresh the page and see if the issue persists and include this information in your bug report.

דיווח על באג או בקשה ליכולת חדשה

אם נתקלתם בבאג בגרסה עדכנית ואף אחד עוד לא דיווח עליו, אז:

1. גשו phabricator.wikimedia.org.
2. תתבקשו להתחבר לחשבונכם (או ליצור אחד) אם טרם עשיתם זאת (ראו "יצירת חשבון ").
3. Click the Bookmark button in the upper right corner and choose "Report a Software Bug" (or "Report a Security Issue" to report a security problem ).
4. מלאו לפחות את השדות הבאים:
   • כותרת (Title): משפט קצר שמסביר את הבעיה (לא הצעה לפתרון).
     • רצוי: "Selecting gender is not functional on Special:Preferences"
     • לא רצוי: "Software crashes"
   • תיאור (Description): הפרטים המלאים של הבעיה, ובהם יש לספק מידע רב ככל האפשר. זה יכול לכלול: If that is insufficient you will be asked for additional information along with guidance on how to obtain it. This field should include:
     • לתקלות:
       • שלבים לשחזור (Steps to Reproduce): שלבים פשוטים וקלים למעקב שאפשר באמצעות לשחזר את הבעיה המתוארת. חשוב לציין הגדרות מיוחדות.

         דוגמה:

         1. Go to https://en.wikipedia.org with Internet Explorer version 10.0;
         2. Make sure you are logged in;
         3. Select "My Preferences" menu;
         4. Go to "Gender" and select female gender from box list;
         5. Click "Save" button.

       • התוצאה בפועל (Actual Results): מה קרה אחרי ביצוע הפעולות

         דוגמה:

         "There is no female gender in front of my username."

       • התוצאה הצפויה (Expected Results): מה הייתה התוכנה צריכה לעשות, אלמלא היה באג

         לדוגמה:

         "My gender is shown in front of my username."

     • עבור בקשות ליכולות חדשות:
       • תיאור של מה מטרת השינוי ותכליתו. Explain what you hope the feature will solve (the actual underlying problem) along with specific examples; but do not demand a specific solution, as there might be other/better solutions. A user story is an effective way of conveying this.

         דוגמה:

         "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"

     • ספקו כל מידע נוסף שעשוי להיות שימושי, כגון:
       • הדפדפן, הרקע (סקין) ומערכת ההפעלה שבו נתקלתם בבאג;
       • קישורים לשינויים בדף אחד או יותר שבהם נתקלתם בבאג; או
       • האם הבעיה מופיעה תמיד, לעתים, או רק בדפים מסוימים או בתנאים מסוימים.
   • על מנת לצרף קובץ יומן צילום מסך (ודאו שהם אינם מכילים מידע פרטי או רגיש), לחצו על כפתור Upload File (בצורת ענן עם חץ) בתפריט הכלים של שדה ה-Description.
   • בחרו פרויקט (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.
     • זה יכול להיות למשל MediaWiki-General project של תוכנת הוויקי עצמה, או Wikimedia-Site-Requests של שינויי הגדרות של אתרי ויקי של ויקימדיה (ראו "Selecting projects ").
   • עותקים (CC): ניתן לדלג על שדה זה: אם אתם יודעים על משתמשים מסוימים שיתעניינו בקבלת עדכונים על המשימה ניתן לציין אותם כאן. Otherwise, ignore this field.

ודאו שהדיווח הושלם, ולאחר מכן לחצו על כפתור יצירת דיווח ("Create Task"). הדיווח ישמר כעת במסד הנתונים ובתקווה יטופל בהקדם. This allows somebody interested in the report to look at it and potentially work on it .

העדיפות למשימה תיקבע על ידי מפתחים אם הם מתכננים לעבוד על המשימה (ראו "קביעת דחיפות").

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

Reporting a JavaScript bug

See also: Help:Locating broken scripts

A lot of functionality, such as gadgets, user scripts, and some parts of MediaWiki, rely on JavaScript.

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 the problem is in the code of a user script or gadget itself, then Phabricator might not be the place where the problem will get handled. Someone might redirect you to the talk page of the script (if the problematic script is identified).

Reporting a connectivity issue

If you are having difficulties reaching a Wikimedia website at all (slow internet connection etc.), please follow https://wikitech-static.wikimedia.org/wiki/Reporting_a_connectivity_issue

Reporting a login problem

If you are having problems logging into your account, please follow Manual:How to debug/Login problems .

Notes

ר' גם

• "כיצד לדווח על באגים באופן יעיל" מאת סימון טטהם (באנגלית)
• Wikimedia Phabricator
  • Phabricator etiquette
• Bug management/Bug report life cycle
• Writing a good bug report or feature request

• English Wikipedia: Bug reports and feature requests