| Peter Vatne inspired me to do something I have been planning to do for a long
time...Several years ago when I was a UIS Devo, I wrote an explanation of why
we want bugs put in the QAR system instead of the notes files. It got spread
around to a number of conferences, and I kept meaning to spread it here, but
never got around to it. Finally, I searched through VMSNOTES and found it.
I should add that we understand that there are a lot of issues around using
the QAR system, especially for those of you connected via slow links. You
don't have to flame.
Here is the note...
----------------------------------------------------------------------------
Let me expound a bit on why we always say that this notes file
(and VMSNOTES and MICROVAX for that matter) are not good places
to report bugs and expect them to get fixed.
The main reasons are
1. Quantity
2. Organization
3. Measurement/Visibility
1. Quantity
We get hundreds of reports of bugs and non-bugs. We have a
limited number of people to work on them. We have to choose some
way to decide which bugs get our attention. (I'm sorry...I would
love to fix EVERY SINGLE BUG and answer EVERY SINGLE QUESTION, but
choices must be made.) The QAR system exists for the purpose of
reporting bugs. Therefore we choose it (and SPRs) as the highest
priority bugs to fix, or at least respond to.
2. Organization
The QAR system is organized specifically to help us track bugs:
what they are, when they were reported, whether they have been fixed,
and who is responsible. Notes are not so organized. If you leave
a bug in the notes file, it requires a lot of manual tracking to make
sure that it does not get forgotten and to coordinate who is keeping
track of it, etc.
3. Visibility
QARs are visible to lots of people: customers, management, other
internal engineers, etc. There is pressure to get QARs answered.
There is less pressure to answer notes files. If someone asks me
why I have not answered my QARs and I say that I was responding
to notes, guess what the response will be?
So what do I think SHOULD be done with bugs and the notes file?
Here is one appropriate procedure, as I see it: You find something
you think is a bug. Put it in the notes file to alert other people
to the problem. Thrash it around. Often you will find it is not
a bug, it is your error, or a "feature" that can be explained in
notes. If it is a bug, perhaps someone can suggest a workaround
and/or other aspects which will make it clearer. When it becomes
clear that it is a bug, someone (probably the original poster) must
take the responsibility to condense the discussion down to a cogent
explanation of the problem and put it into the QAR system. There
are probably other appropriate procedures, but they have one thing
in common: If there is a real bug, that bug gets into the QAR system
somehow.
If you don't have an account on the QAR system, send mail to
TRIFID::QAR$MANAGER.
Thanks to everyone for your understanding. With everyone's help,
we can keep weeding the bugs out of VWS.
Burns
|