Difference between revisions of "Bug and Issue Tracker Priority"

From Joomla! Documentation

(New page: You've been trying to solve it for hours, no one on the forums has been able to help, the issue seems not to be covered in the documentation, and you are probably on a deadline too. Time t...)
 
Line 7: Line 7:
 
The artifacts are prioritized according to the following characteristics:
 
The artifacts are prioritized according to the following characteristics:
  
#High/Critical: The trunk is not working at all. Significant parts of the source are broken preventing key operations.  Examples would be login, installation, extenstion installers, javascript errors that prevent you from moving a save or similar action, etc.  Also includes the generation of Fatal PHP errors for .
+
#'''High/Critical''': The trunk is not working at all. Significant parts of the source are broken preventing key operations.  Examples would be login, installation, extenstion installers, javascript errors that prevent you from moving a save or similar action, etc.  Also includes the generation of Fatal PHP errors for .
# Medium High/Major: Parts of the source are obstructing operation in a serious way or causing a major loss in advertised function.  
+
# '''Medium High/Major''': Parts of the source are obstructing operation in a serious way or causing a major loss in advertised function.  
# Medium/Normal: Issues that are hindering advertised behaviour but the application is still workable.  Examples would include parameters not working as advertised, language files not loading as expected, etc.
+
# '''Medium/Normal''': Issues that are hindering advertised behaviour but the application is still workable.  Examples would include parameters not working as advertised, language files not loading as expected, etc.
# Low/Minor: Minor loss of function and generally annoying behaviour.  May include less common platform or browser specific problems that while they may be technically major in those environments, they represent a minority.  Also include missing translation strings.
+
# '''Low/Minor''': Minor loss of function and generally annoying behaviour.  May include less common platform or browser specific problems that while they may be technically major in those environments, they represent a minority.  Also include missing translation strings.
# Very Low/Trivial: Cosmetic problems, mis-spelled words, graphically mis-aligned object, less common issues with parameters, etc.
+
# '''Very Low/Trivial''': Cosmetic problems, mis-spelled words, graphically mis-aligned object, less common issues with parameters, etc.
  
 
What does this mean?
 
What does this mean?

Revision as of 16:04, 5 September 2008

You've been trying to solve it for hours, no one on the forums has been able to help, the issue seems not to be covered in the documentation, and you are probably on a deadline too. Time to submit it to the tracker. After all that effort, it sure seems like a critical issue. So, you select a priority level of high.

Then what happens? Someone from JBS goes and changes it to medium. Why did they do that? Does that mean your issue isn't important and it won't be dealt with? Are they just mean and uncaring?

Of course not. It just turns out the the development work group has pretty strict definitions of artifact priority levels.

The artifacts are prioritized according to the following characteristics:

  1. High/Critical: The trunk is not working at all. Significant parts of the source are broken preventing key operations. Examples would be login, installation, extenstion installers, javascript errors that prevent you from moving a save or similar action, etc. Also includes the generation of Fatal PHP errors for .
  2. Medium High/Major: Parts of the source are obstructing operation in a serious way or causing a major loss in advertised function.
  3. Medium/Normal: Issues that are hindering advertised behaviour but the application is still workable. Examples would include parameters not working as advertised, language files not loading as expected, etc.
  4. Low/Minor: Minor loss of function and generally annoying behaviour. May include less common platform or browser specific problems that while they may be technically major in those environments, they represent a minority. Also include missing translation strings.
  5. Very Low/Trivial: Cosmetic problems, mis-spelled words, graphically mis-aligned object, less common issues with parameters, etc.

What does this mean?

First of all, if it is not within the first few days of a release and it doesn't involve a security issue, unless you are using subversion or a nightly build you will most likely never see a prioirty 1 (high) issue or need to report one. That's because if there are any open priority 1 issues in the codebase, there will not be a release. The same thing actually goes for prioirty 2 (medium high). A real prioirty 1 issue in an actual release is something that would trigger a new release. A priority 1 or priority 2 issue in the 1.5 branch of codebase would keep a scheduled release from taking place. This is serious, because each release contains many bug fixes and improvements, so not releasing keeps most of the community from getting those. Forcing an unscheduled release is serious too, because it means that work on other things stops while all efforts are put into getting the release ready.

The one exception would be if you discover a major security issue, but the tracker is not usually the place to report most security issues.

This doesn't mean that there are never prioirty 1 or 2 issues. A prioirty 1 issue may develop (http://joomlacode.org/gf/project/joomla/tracker/?action=TrackerItemEdit&tracker_item_id=11225) in the current Joomla! source code that is in Subversion. Subversion is where all of the changes to the source code are made.

So, before you decide to mark an issue as priority 1 or priority 2, think about whether it would really warrant all of these things.

Most issues are priority 3, medium. However, some issues are priority 4 or 5 If you mark your issue as prioirty 4 or 5 does that mean it will not get fixed? Not at all. If it's an easy to fix issue, especially if you provide a patch or proposed code, it may get taken care of right away. Some people in JBS informally specialize in language issues or CSS or other topics that are often in prioirty 4 or 5 issues. So don't feel like you need to mark something prioirty 3 for it to get attention.