1,633
edits
Bugtracker: Difference between revisions
m
no edit summary
mNo edit summary |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{TOCright}} | {{TOCright}} | ||
The [http://tracker.anidb.net AniDB Bugtracker] is based on the [http://www.mantisbt.org/ Mantis Bug Tracking System], and so you can read its [http://manual.mantisbt.org/ full documentation] if you have doubts after reading this guide. | The [http://tracker.anidb.net AniDB Bugtracker] is based on the [http://www.mantisbt.org/ Mantis Bug Tracking System], and so you can read its [http://manual.mantisbt.org/ full documentation] if you have doubts after reading this guide. | ||
The Tracker has its separate user database so neither the forum accounts, nor wiki accounts nor AniDB logging will work on it. We encourage all active users to create an account and submit Bugs Reports and Feature Requests there. It's easier for us and will be better for you (more probability for developers to read your reports/request and remember them after some time). Anyway, if you plan to start long discussions [http://anidb.net/perl-bin/animedb.pl?show=forum the forum] is still better. You can report the issue in the Tracker and link a forum thread in the description (that's the recommended procedure). ;) | The Tracker has its separate user database so neither the forum accounts, nor wiki accounts nor AniDB logging will work on it. We encourage all active users to create an account and submit Bugs Reports and Feature Requests there. It's easier for us and will be better for you (more probability for developers to read your reports/request and remember them after some time). Anyway, if you plan to start long discussions [http://anidb.net/perl-bin/animedb.pl?show=forum the forum] is still better. You can report the issue in the Tracker and link a forum thread in the description (that's the recommended procedure). ;) | ||
==How to use it?!== | ==How to use it?!== | ||
The main purpose for this tracker is to organize the Bug Reports and Feature Requests made on a daily basis and to keep track of their status and evolution. Because of this, all AniDB related projects have a separate tracker project to handle all reports/requests in an organized way. You can switch between them with the combo box in the right top most part of the page. This is the current list of available projects: | The main purpose for this tracker is to organize the Bug Reports and Feature Requests made on a daily basis and to keep track of their status and evolution. Because of this, all AniDB related projects have a separate tracker project to handle all reports/requests in an organized way. You can switch between them with the combo box in the right top most part of the page. This is the current list of available projects: | ||
:; AniDB Anime Hint : for all issues related to the hint system. | :; AniDB Anime Hint : for all issues related to the hint system. | ||
| Line 20: | Line 20: | ||
===My view=== | ===My view=== | ||
The first page after login is "My View" where you can see a quick overview of all the issues and their status organized by groups. You can click over any of those 'numbered' links (i.e. 0000023) to go to the detail page. Clicking over any group header will take you to the full list of issues for that group. You can't do much more here. | |||
The first page after login is "My View" where you can see a quick overview of all the issues and their status organized by groups. You can click over any of those 'numbered' links ( | |||
===Viewing the list of issues=== | ===Viewing the list of issues=== | ||
The View issues page has a sorted list of all issues where you can apply filters by any combination of properties and even search over those filtered results. There are a couple of columns that are not that easy to get. First is the one named "P" (for Priority) that stresses issues with a high or a low priority (assigned by the developer). Second is the "#" column that has the number of notes added to the issue. The rating column shows the public rating for that feature with the total number of votes enclosed by "[]". You can sort the page by any of the highlighted columns and the sorting direction will be shown by a graphical arrow in the active column. Take in account that the default list filter doesn't show closed issues. If you want to see them please enable it by changing the Status filter (click over the Status text in the filter box and set Hide Status to none). | The View issues page has a sorted list of all issues where you can apply filters by any combination of properties and even search over those filtered results. There are a couple of columns that are not that easy to get. First is the one named "P" (for Priority) that stresses issues with a high or a low priority (assigned by the developer). Second is the "#" column that has the number of notes added to the issue. The rating column shows the public rating for that feature with the total number of votes enclosed by "[]". You can sort the page by any of the highlighted columns and the sorting direction will be shown by a graphical arrow in the active column. Take in account that the default list filter doesn't show closed issues. If you want to see them please enable it by changing the Status filter (click over the Status text in the filter box and set Hide Status to none). | ||
===Viewing an Issue details=== | ===Viewing an Issue details=== | ||
This page will show you all the info related to the report/request, and there are some things to take in account. First, you can add notes to the issue while logged in. This input box allows you to enter HTML code (like <code><nowiki><b></nowiki></code>, <code><nowiki><i></nowiki></code>, <code><nowiki><u></nowiki></code> and <code><nowiki><pre></nowiki></code> tags for formatting). Second, please don't use this feature to chat with other users. Ask yourself before posting if the input would be useful to the developers. Third, you can also rate the issue so they know if it's welcomed by all the community or just wanted by a single user. And last, you can also monitor the issue, meaning you will receive an e-mail for every update made to it. Just click on the Monitor button and click again to disable that. | This page will show you all the info related to the report/request, and there are some things to take in account. First, you can add notes to the issue while logged in. This input box allows you to enter HTML code (like <code><nowiki><b></nowiki></code>, <code><nowiki><i></nowiki></code>, <code><nowiki><u></nowiki></code> and <code><nowiki><pre></nowiki></code> tags for formatting). Second, please don't use this feature to chat with other users. Ask yourself before posting if the input would be useful to the developers. Third, you can also rate the issue so they know if it's welcomed by all the community or just wanted by a single user. And last, you can also monitor the issue, meaning you will receive an e-mail for every update made to it. Just click on the Monitor button and click again to disable that. | ||
===Reporting an issue=== | ===Reporting an issue=== | ||
We would like all people to participate in this interactive community and make reports for all of the available AniDB projects, but please read this before doing so. A bad report is worse than no report at all, but we appreciate your time and we will like to see you helping us. Please, before submitting a report check if it wasn't done before (duplicated reports will be closed as spotted). Take in account that by default closed issues are not shown (check viewing issues). | |||
We would like all people to participate in this interactive community and make reports for all of the available AniDB projects, but please read this before doing so. A bad report is worse than no report at all, but we appreciate your time and we will like to see you helping us. Please, before submitting a report check if it wasn't done before (duplicated reports will be closed as spotted). Take in account that by default closed issues are not shown (check viewing issues). | |||
; Category : please choose the proper category. We decided to split categories in two main groups, Bug Report and Feature Request. | :; Category : please choose the proper category. We decided to split categories in two main groups, Bug Report and Feature Request. | ||
; Reproducibility : set the reproducibility factor of the issue. For Feature Requests set "N/A". | :; Reproducibility : set the reproducibility factor of the issue. For Feature Requests set "N/A". | ||
; Severity : set the severity (in your opinion) for the issue. For Feature Requests set "feature". | :; Severity : set the severity (in your opinion) for the issue. For Feature Requests set "feature". | ||
; Summary : try to make a short but clear explanation of the issue. You can then explain it in a longer way in the Description property. | :; Summary : try to make a short but clear explanation of the issue. You can then explain it in a longer way in the Description property. | ||
; Description : try to be as much detailed as you can. This input box allows you to enter HTML code (like <code><nowiki><b></nowiki></code>, <code><nowiki><i></nowiki></code>, <code><nowiki><u></nowiki></code> and <code><nowiki><pre></nowiki></code> tags for formatting), so be aware of this when you want to make some things stick out from the rest or keep a formatting (<code><nowiki><pre></nowiki></code> tag). | :; Description : try to be as much detailed as you can. This input box allows you to enter HTML code (like <code><nowiki><b></nowiki></code>, <code><nowiki><i></nowiki></code>, <code><nowiki><u></nowiki></code> and <code><nowiki><pre></nowiki></code> tags for formatting), so be aware of this when you want to make some things stick out from the rest or keep a formatting (<code><nowiki><pre></nowiki></code> tag). | ||
;Additional Information : any additional information you consider useful for the issue (affected version is a very useful information). | :;Additional Information : any additional information you consider useful for the issue (affected version is a very useful information). | ||
; View Status : public reports will be seen by everyone, including anonymous login. Private ones will be seen by people with at least reporting rights for the project. | :; View Status : public reports will be seen by everyone, including anonymous login. Private ones will be seen by people with at least reporting rights for the project. | ||
; Report Stay : click this to continue reporting more issues. | :; Report Stay : click this to continue reporting more issues. | ||
''There is an advanced view for reports/requests but we don't recommend using it as most of the times the additional info is not useful for the developer.'' | ''There is an advanced view for reports/requests but we don't recommend using it as most of the times the additional info is not useful for the developer.'' | ||
===Final commentaries=== | ===Final commentaries=== | ||
You can change your data in the page "My Account" and set your account preferences and system language. | |||
You can change your data in the page "My Account" and set your account preferences and system language. | |||
The Tracker is a useful tool to help developers organize Bug Reports and Feature Requests. Well used will help reduce times of development and tracking of issues. | The Tracker is a useful tool to help developers organize Bug Reports and Feature Requests. Well used will help reduce times of development and tracking of issues. | ||
Thanks for reading this and we hope you start to contribute. | Thanks for reading this and we hope you start to contribute. | ||
[[Category:Features]] | [[Category:Features]] | ||