[[PageOutline]]

= ACPI Ticket Processing Guide =

This guide is written for both developers and reporters.

== Entering New Tickets ==

When a new ticket is created, the milestone will default to the milestone
corresponding to next scheduled ACPI version release.  As of 1/26/2009, this
is ACPI version 3.15.

The version will default to current ACPI version (i.e. 3.15).

These default values are defined by the ACPI project manager.

When submitting a ticket, reporters should override these values if
needed.

A well written ticket will contain sufficient information so that the
developer can respond to the ticket without the need to request additional
data.  Reporters should attempt to make this happen.

== Handling New Tickets ==

Developers should review and respond to new tickets within 1 or 2 working days.
As always, sooner is better.

When the ticket is reviewed, developers should change the ticket status to 
assigned.

Developers should correct the milestone and version fields, as needed.

If the reporter has neglected to supply the appropriate logs, the
developer should point the reporter to
http://svn.netlabs.org/acpi/wiki/WikiStart#SubmittingTickets and
http://ecomstation.ru/projects/acpitools/?action=logs.

== Displaying Tickets Requiring Developer Attention ==

To display the list of the tickets that need attention, click on the roadmap link,
click on the current milestone and click on the open ticket count link.

It is recommended that developers bookmark the resulting Custom Query.  This
will provide one-click access to this ticket list.

The developers may choose to ignore tickets not displayed on this list.

If a reporter believes a ticket has been incorrectly assigned, add a note to
the ticket explaining why.  This note will be seen by ACPI project
management.

== Using the Feedback Milestone ==

If the reporter fails to supply requested data in a reasonable period of time,
reassign the ticket to the [http://svn.netlabs.org/acpi/milestone/Feedback%20pending
Feedback Pending milestone].

A reasonable period of time is probably 5 working days.  This helps avoid
cluttering up the list of tickets requiring developer attention with tickets
where the developer is waiting for the reporter.  It also generates ticket
e-mail to the reporter reminding the reporter that we are waiting for them.

In general, once a ticket is moved to Feedback Pending milestone, it will be
ignored by the developers.

== Responding to Tickets assigned to the Feedback Milestone ==

If you are a reporter responding to a ticket assigned to the Feedback
milestone, try to remember to reassign the ticket to the current milestone.
This will help ensure that the developer is aware of the response.

== When to Close Tickets ==

Tickets will only be be closed as resolved when the reported issue is
fully resolved.

  * A ticket is considered resolved when the reporter states that the issue no longer occurs.

When an ticket is resolved by code changes, the code changes must be 
submitted to the Subversion respository before the ticket is closed.

When an ticket is resolved by code changes, a comment must be added to the 
ticket indicating the Subversion change set number.

When an ticket is resolved by code changes, a comment must be added to the 
ticket indicating the nature of the code change and how it resolved the 
ticket issue.

When an ticket is resolved by code changes, instruct the reporter to test
the new version when it is released and move the ticket to the Feedback
Pending milestone.

If a ticket will not be resolved by the new version release, leave the ticket
open.  If desired, move the ticket to a future milestone.  This will take
the ticket off the list of tickets requiring developer attention for the
current milestone.

== Maintaining Tickets After a New Release ==

When a new version is released and the milestone corresponding to the new
version is be marked complete, there will usually still be open tickets for
the milestone.  Any remaining open tickets will automatically be moved to
the next milestone.

== Handling Stale Tickets ==

Over time, stale tickets will accumulate in the Feedback Pending milestone.
The ACPI project manager will monitor this milestone and determine how to
dispose of these tickets.