نحوه گزارش یک اشکال
- To ask technical questions about Wikimedia projects, see m:Tech
- To ask technical questions about MediaWiki in non-WMF installations, see Project:Support desk
این دستورالعمل ها توضیح می دهند که چگونه یک گزارش اشکال (باگ) خوب یا درخواست قابلیت در Wikimedia's bugtracker نوشته شود (برای اطلاعات بیشتربه فابریکاتور نگاه کنید). گزارشات باگ موثرتر احتمال بیشتری برلی اصلاح خواهند داشت. گزارشات اشکال (باگ) باید به زبان انگلیسی باشند. اگر شما مسلط به زبان انگلیسی نیستید، سعی کنید از یک ابزار ترجمه ماشینی مانند مترجم گوگل استفاده کنید.
توصیه‌های سبک
- دقیق باشد
- واضح باشید: توضیح دهید: ۱) نحوه بازتولید موقعیت، مرحله به مرحله، بدون اینکه جایی برای تفسیر باقی بماند، ۲) رفتار مورد انتظار، ۳) رفتار واقعی. در بخش های جداگانه
- فقط یک اشکال خاص یا یک درخواست ویژگی خاص در هر کار را شامل شود
- شامل هر پیوند و مثال مرتبط
قبل از اینکه کاری انجام دهید
آیا می توانید موضوع را تکرار کنید؟
سعی کنید باگ خود را با استفاده از نسخه اخیر نرم افزار بازتولید کنید تا ببینید آیا قبلاً رفع شده است یا خیر. اگر اشکال در یک سایت ویکی مانند ویکی پدیا است، می توانید آخرین نسخه نرم افزار را در test2.wikipedia.org آزمایش کنید.
آیا کسی در حال حاضر این مشکل را گزارش داده است؟
Use the search box of Wikimedia's bugtracker to see if your bug has already been reported, or the feature requested. You can also perform more advanced searches on the advanced search page.
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.
گزارش دادن مشکل یا درخواست ویژگی
اگر در نسخه اخیر با یک باگ مواجه شده اید و به نظر می رسد هیچ کس دیگری آن را گزارش نکرده است، پس:
- برو بهphab:lphabricator.wikimedia.org.
- اگر قبلاً این کار را نکرده‌اید، باید وارد شوید (یا ثبت نام کنید) (به «ایجاد حساب خود» مراجعه کنید).
- روی دکمه نشانک در گوشه سمت راست بالا کلیک کنید و «گزارش یک اشکال نرم‌افزار» (یا «گزارش یک مشکل امنیتی» را برای گزارش یک مشکل امنیتی انتخاب کنید).
- حداقل فیلدهای زیر را پر کنید:
- عنوان:یک خلاصه کوتاه یک جمله ای که مشکل را توضیح می دهد (نه راه حل پیشنهادی شما).
- خوب:
"Selecting gender is not functional on Special:Preferences" - بد:
"Software crashes"
- خوب:
- توضیحات: جزئیات کامل موضوع، ارائه تمام اطلاعاتی که در حال حاضر دارید. اگر این کافی نیست، از شما اطلاعات بیشتری به همراه راهنمایی در مورد نحوه به دست آوردن آن خواسته می شود. این فیلد باید شامل موارد زیر باشد:
- برای اشکالات:
- «مراحل بازتولید:» مراحل به حداقل رسیده و آسان برای دنبال کردن که باعث ایجاد مشکل توصیف شده می‌شود. هر مرحله راه‌اندازی ویژه را شامل شود.
- مثال:
Go to https://en.wikipedia.org with Internet Explorer version 10.0;Make sure you are logged in;Select "My Preferences" menu;Go to "Gender" and select female gender from box list;Click "Save" button.
- مثال:
- Actual Results: What the application did after performing the above steps.
- مثال:
"There is no female gender in front of my username."
- مثال:
- Expected Results: What the application should have done, if there was no bug.
- مثال:
"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"
- مثال:
- شرح آنچه دوست دارید به دست آورید و چرا. 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.
- Please also provide any other information that might be useful, such as:
- the web browsers, skins, or computer systems you've seen the bug on;
- links or diffs to one or more pages where you encountered the bug; or
- whether the problem appears every time, only occasionally, only on certain pages, or only in specific circumstances.
- برای اشکالات:
- To attach a log file or screenshot (but make sure that no confidential data is included or shown), click the Upload File button (a cloud with an arrow) in the tool bar of the Description field.
- Select the tags (project(s)) in which you've found the bug:
- 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.
- This could be for example the
MediaWiki-Generalproject for the wiki software itself, orWikimedia-Site-Requestsfor configuration changes on a Wikimedia site (see Selecting projects).
- Subscribers: If you know specific users who will be interested in getting notified of this task you can add them here. Otherwise, ignore this field.
- عنوان:یک خلاصه کوتاه یک جمله ای که مشکل را توضیح می دهد (نه راه حل پیشنهادی شما).
Check if your report is complete, then press the "Create Task" button. Your report will now be in the database. This allows somebody interested in the report to look at it and potentially work on it.
The priority for the task will be set by developers if they plan to work on the task (see Setting priorities).
That's all! Thanks for your help to improve MediaWiki and Wikimedia projects!
گزارش یک اشکال جاوا اسکریپت
- همچنین ببینید: 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.[1] Someone might redirect you to the talk page of the script (if the problematic script is identified).
گزارش مشکل اتصال
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
گزارش اشکال در ورود به سامانه
If you are having problems logging into your account, please follow Manual:How to debug/Login problems.
یادداشت‌ها
جستارهای وابسته
- How to Report Bugs Effectively by Simon Tatham