Tracker Usage

This page contains information that may be out-of-date, please check the FreeCol Bug Tracker for the most current bug reporting procedures.

The following procedures should be followed when you work on an open bug in the FreeCol Bug Tracker.

How to update a bug tracker item while you are working on it

  1. Assign yourself to the tracker item before you start working on it.
  2. Please verify that no duplicate entry has been posted. If you can find a duplicate:
    • If the bug has NOT been fixed, please use the resolution "Duplicate", set the status to "Closed" and post a comment with the ID of the other tracker item (add a comment to the other tracker item as well).
    • If the bug has been fixed, use the resolution "Out of date" and close the tracker item.
  3. Set the item's status to pending if you require input from the person originally submitting the item.
  4. If you are unable to complete the item: Assign it to "None" and make a comment describing any problems relevant for another developer.
  5. After you have completed the work: Set the group to "Fixed (trunk)", resolution to "Fixed" and the status to "Closed". Please also write a comment telling that the work is done.
    If the bug is fixed in a branch, you should set the group to fixed for that branch, but it must be fixed in trunk too.

You can use any suitable canned response instead of writing a comment. For example: You can use the "Fixed: Use Subversion" after you have fixed a bug.

How to update a feature request item while you are working on it

  1. Assign yourself to the tracker item before you start working on it.
  2. Please verify that no duplicate entry has been posted. If you can find a duplicate:
    • If the feature has NOT been implemented, please use the group "Duplicated", set the status to "Closed" and post a comment with the ID of the other tracker item (add a comment to the other tracker item as well).
    • If the feature has been implemented, use the group "Out of date" and close the tracker item.
  3. Set the item's status to pending if you require input from the person originally submitting the item.
  4. Set the group "Accepted" if you decide that this feature request should be added before the next release (please discuss on the mailing list if there are any reasons not to include this feature).
  5. If you are unable to complete the item (or you think someone else should be implementing it): Assign it to "None" and make a comment describing any problems relevant for another developer.
  6. After you have completed the work: Set the group to "Added (trunk) resolution to "Fixed" and the status to "Closed". Please also write a comment telling that the work is done.
    If the bug is fixed in a branch, you should set the group to fixed for that branch, but it must be fixed in trunk too.

You can use any suitable canned response instead of writing a comment. For example: You can use the "Added: Use Subversion" after you have implemented a feature.