Trac ticket workflow: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
mNo edit summary
Line 3: Line 3:
Here is an approximate common path, subject to circumstances.
Here is an approximate common path, subject to circumstances.
Set the 'Action Needed' field in Trac sequentially to:
Set the 'Action Needed' field in Trac sequentially to:

diagnose,
reproduce -- first we need to know how to reproduce your issue
design,
diagnose -- then its root cause needs to be diagnosed
code,
design -- at which time we can design...
package,
code -- and code a fix.
add to build,
review -- to ship the fix, we need to review it,
test in build,
testcase -- write a test case for it,
qa signoff,
package -- and package it up as an RPM, an activity, etc.
finalize.
add to build -- then package needs to be added to a build
test in build -- and the packaging needs to be tested.
qa signoff -- some developers will want QA to review their work...
finalize -- before it is added to the release notes


After testing in a build, the developer tags the bug with the results, e.g.:
After testing in a build, the developer tags the bug with the results, e.g.:

Revision as of 23:40, 18 August 2008

First draft

Here is an approximate common path, subject to circumstances. Set the 'Action Needed' field in Trac sequentially to:

 reproduce       --  first we need to know how to reproduce your issue
 diagnose        --  then its root cause needs to be diagnosed
 design          --  at which time we can design...
 code            --  and code a fix.
 review          --  to ship the fix, we need to review it,
 testcase        --  write a test case for it,
 package         --  and package it up as an RPM, an activity, etc.
 add to build    --  then package needs to be added to a build
 test in build   --  and the packaging needs to be tested.
 qa signoff      --  some developers will want QA to review their work...
 finalize        --  before it is added to the release notes

After testing in a build, the developer tags the bug with the results, e.g.:

 joyride-2126:-    or   joyride-2126:+

( '-' means bad result, try again, whereas '+' means good result )

I presume this is after the "test in build" state, which I presume means the developer who coded the fix tested it in a build. That could be clearer. Then, what does the developer do? Just set it to "qa signoff"? Assign it to some QA person? At what point does it get tagged into the 8.2 release stream, and should it be assigned to someone to ensure that? --morgs 09:59, 17 July 2008 (UTC)

The purpose of the finalize state is for the release team to provide any user-facing documentation or to conclude that no documentation is necessary.

The workflow can be exited early by resolving a ticket as 'worksforme', 'invalid', etc.

At various times, someone (e.g. the developer or the release team) may need an answer to a question. In this event, the ticket's next action should be set to 'communicate'.

Finally, the other 'Action Needed' states can be used to describe ignorance about what sort of action is needed. The regular Trac triage process will be responsible for pushing these tickets along.