Revision as of 11:04, 15 April 2009

EclipseLink Bug Report Guidelines

Severity

The Severity field is used as an indication of the filer's impression of the severity of the bug. Except in cases of abuse of this field, it should usually be left as initially set. The exception to this rule is that some bugs are clearly enhancements rather than bugs. They can be changed to Enhancements.

Enhancements are reviewed when they are initially entered, but if not targetted at that time, will only be reviewed when release planning occurs. At that time, any candidates for the upcoming release should be targetted.

Priority and Target Milestone

Bugs will be triaged on approximately a weekly basis to set Priority and Target Milestone. Triaged bugs will have a Target Milestone set at that time. Target milestone will either be a specific version or one of the following:

• "Future" - The goal is to make this the only setting for triaged bugs with no specific target
• "1.1x" - this setting deprecated, 1.1x bugs will be retriaged and have a new target and priority set.

If the "Target Milestone " is set to "Future" the priority field indicates the bug's priority relative to other bugs with a "Future target". i.e. P1 bugs will be targetted before P2 bugs, P2 bugs before P3 bugs and so on...

Note: if Target Milestone is not set, this means the bug has not been triaged and the Priority and Target Milestone have not been set by the team

If the Target Milestone is set to a specific version, the following values are used in the priority field

• P1 - Urgent bug fix. Someone should work on this immediately
• P2 - Required for Release. This fix is a requirement for the release listed in the target field.
• P3 - This is the default. Targetted for the listed release, but not considered a blocker
• P4 - Nice to have, time permitting
• P5 - Lower priority - likely to be deferred

Keywords

We use the following keywords at this time:

• test - for bugs that are issues with a test (rather than the code the test is exercising)
• performance - for bugs that describe an issue that the key effect is on performance
• contributed - should be added to a bug on any community submitted patch when it is checked in

Status Whiteboard

The following status whiteboard strings are recognized

• simple_fix - for issues where the fix is a trivial change, something that can be undertaken in a matter of minutes. Some examples of this kind of bug is a typo in an error message or a comment, a wording issue with an Error message, or an unused import in a single file.
• submitted_patch - indicates that a member of the community has submitted a patch. This allows us to search for these issues and expedite their inclusion in the product.

Summary

The summary field of an issue with the build should be prepended with the string: [Build]