Difference between revisions of "Contribute/Bugsquad/How to triage bugs"

Jump to: navigation, search
(Special Instructions and Version fields: add kmail)
(If I can still replicate a bug: add triaged keyword)
Line 68: Line 68:
  
 
=If I can still replicate a bug=
 
=If I can still replicate a bug=
See if it has a testcase, see if you can write one, put it on the wiki. Add a note saying the bug is still present and again, don't forget to give what version you're using.
+
See if it has a testcase, see if you can write one, put it on the wiki. Add a note saying the bug is still present and again, don't forget to give what version you're using: distro/source (ie svn revision number)/snapshot.
 +
 
 +
Add the "triaged" keyword in bugzilla.
  
 
=Special Instructions and Version fields=
 
=Special Instructions and Version fields=

Revision as of 01:29, 25 September 2008

Contents

To join in a BugDay OR to learn on your own

(You can do this anytime, picking a day just helps us focus. It's how we do our basic training.)

  • Get a bugzilla (bz) account.
  • Get a techbase account and set the preferences to "edit by section". This is to prevent edit conflicts.
  • Join #kde-bugs.
  • Go to the current BugDay page in the url of the #kde-bugs topic. Or, if you are doing this on your own, go to the "Ongoing Konqueror Triage" page.
  • "Sign in" (so we know what version you were testing with and that you were here)
  • "Check out"/take a month of bugs, and work through them.
  • Always comment on both bugzilla and the wiki:
    • Always comment on bugzilla, since that's the main way of tracking things, and what devs will pull up first, remember to add what version you tested with!
    • The wiki is what we use to sort what we've done, and to make sure people are doing the right thing. It is also where we discuss what we should do with bugs.

Also, if you are new, this is where we will keep track of how you are doing.

      • New People: After you have done a bugset or two, find one of the other active people on channel (or ping grundleborg or blauzahl) and ask them to look over your bugs. You can ping and leave, we log. :)
  • Policy decision? --> Escalate it to developers.
  • Unsure of anything? Ask!
  • Here's what you should look for:

See if the bug still exists

The first three mostly apply to Konqueror & rendering bugs:

  • If there isn't a testcase, see if you can make one. That can be time consuming. If there is one, it should be in the bugzilla subject line as [testcase].

If it has a testcase, toss it into the "testcase section" of the wiki. If it is a fixed bug, put it under the "fixed" section, AND mention that it has a testcase. This way all the testcases can be added to the test regression suite.

If you can't make a testcase, note "testcase needed" in the wiki.

  • On "site-issue" bugs, it could be a 6-year-old site which has vanished. So read the comments, because there might be a useful testcase, or something describing what was the problem. If it looks like there's enough to give a developer something to go on, put it under the "needs attention from developer" section.

Also, try http://archive.org and see if you can pull up the site from around that time. Paste that link in the report, or better yet, make a testcase and put that in.

  • If it has little information, and the site doesn't exist ---> INVALID *g*
  • If you can't change bug information yet, then just write your comment on the bug. Always include your version/revision number and distro/trunk/branch (you already wrote it on the wiki when you "signed in", right?). Mention on the wiki that you can't change it yet ("no perms", etc.), and someone will go through with you later, and double check stuff and mark things. Don't worry, you'll have bugzilla permissions pretty quickly.
  • If you aren't sure about something, get a second opinion, and mention who seconded on the wiki, especially if it was a developer. (saves us work)
  • If it works for us, then we close the bug with the chipper WORKSFORME.
  • If you know what piece of code fixed it (usually we won't, but a developer would), then you close with FIXED.
  • The nice way of closing bugs that don't have enough information and you think are likely to be invalid at this point is REMIND. And add a note saying "if this is still a problem in a current version, please reopen with more information."

(Or you can close with INVALID or WONTFIX, depending on what it is. Different programs/developers have different styles, i.e. REMIND vs. WONTFIX/INVALID. If you find yourself triaging for one package, you might want to find out the maintainer's style and follow that.)

Ktip.png
 
Tip
Old Konqueror bugs aren't likely to have duplicates. Always get a second opinion on those, traditionally duplicates are the highest false positives in BugDays, and we do NOT want to close valid, real bugs. In old Konqueror bugs, we've found about 1% duplicates. (This isn't the case with incoming bugs.) So don't worry about finding duplicates if you are new.


Flash

Many of the incoming flash bugs are duplicates. They are most useful if they are reproducible and have good instructions on how to reproduce them, or a URL. Also the reporter should give: flash version, kde version, 32/64bit. The backtraces will be incomplete inside of the flash functions: there are no debug symbols for it (closed source). Backtraces are still useful if flash is causing a crash though, because it helps us figure out how to work around it or tell if they have something misconfigured.

See the flash wikipage: http://techbase.kde.org/index.php?title=Contribute/Bugsquad/BugDays/flashplugin

It would be nice if you go through and comment on these test cases, you don't even need a bugzilla or techbase account.

If I can still replicate a bug

See if it has a testcase, see if you can write one, put it on the wiki. Add a note saying the bug is still present and again, don't forget to give what version you're using: distro/source (ie svn revision number)/snapshot.

Add the "triaged" keyword in bugzilla.

Special Instructions and Version fields

In general, you never change the version field, unless it is to remove "unspecified" and replace it with the version the bug was reported against. Do not "update" Version:, use comments to write what version you are testing with. As always, when commenting, say what distro/version source build you are using.

There are some components which are an exception or which have other special instructions:

KMail

They have requested we update their version fields.

What if it doesn't work in 3.5.x but it's fixed in 4?

3.5.x is not in active development at this time. Technically speaking, it's seven+ releases out of date. True, 4.1.x doesn't have all the functionality of 3 yet, but 3.5.x is past string freeze, feature freeze, etc. Keep that in mind as you go through old reports. You can use this to justify closing items fixed in trunk, while being nice to reporters who say they can't upgrade.

(Bugzilla actually has states (resolved -> verified -> closed) to keep track of code shipping, etc., but it's just a waste of time for us, so we don't use it that way.)

Normally bug reports are fixed in the current development version (trunk), and "safe" bugfixes are backported to the current stable version (4.0 branch). Older versions just get security fixes. If something got messed up only on the stable branch, it gets fixed there.

The point of bugzilla is to keep track of what needs fixing in versions currently being worked on.

The rule:

Once a bug is fixed in SVN trunk, it can be closed.

Shall I say it again? This is true for 4.1 vs. SVN trunk too!

noframe
 
Warning
If a bug is fixed in SVN trunk, it can be closed. Even if it still exists in 4.1.x!


This won't necessarily make users happy, so be nice about closing old bugs. Here are some further guidelines:

Konqueror/KHTML

They are not actively developing 3.5.x Crashes: If it happens on cnn.com or some such important site, it might get backported, otherwise, they're not going to be touched. Ask channel how important they think it is, and then go bug a developer to backport.

If konqueror crashes when restoring session, please zip the $KDEHOME/share/apps/konqueror/autosaved directory and attach it to the bug report. This way the developers will be able to restore the problematic konqueror session exactly as you do, and it will be easier to fix the problem.

Konqueror/Dolphin

There was major code change between 3 & 4. Any kind of backport is probably undoable.

KOffice bugs

SKIP these bugs There is ongoing major code change. They won't change 1.6 bugs, but 2.0 is still alpha. The developers want to keep their bugs open to check for regressions later on.

But KDE4 isn't ready!

If you see someone saying their bug shouldn't be closed until everyone (read: that person) could give up kde3, try to come up with something nice to say, but really what they think is irrelevant. This is a case where we can take the heat for developers. We don't want them to have to deal with this stuff.

Put all bugs you look at on the wiki!!!

It gives us an easy way to go through and double check what people have done, especially useful for those who don't have bugzilla perms.

But you also have to mark things on bugzilla, that's where developers will keep track of things. We use the wiki to coordinate our own efforts.

Where on the wiki do I edit?

Depends on what section: Perhaps you'd like to see previous examples?

http://techbase.kde.org/index.php?title=Contribute/Bugsquad/BugDays/

You'll see how it's ended up looking now that we've gone through it a few times We're not putting any new bugs on there.

Ktip.png
 
Tip
If you just got a techbase wiki account, set the preferences to let you edit by section.


We also use the wiki to some extent to coordinate comments, at least to document what we said in irc.

We want to keep it all on one page, because on the 2nd and 3rd pass, we tend to move things around a LOT from section to section as stuff changes.

how many open bugs are against KDE as a whole?

A ton. You can check at http://bugs.kde.org/weekly-bug-summary.cgi You can also click through to your favorite application and see its components' bugs. They will be sorted by severity here, so this is one way to go look at a list of crashes or wishlists. If you look at the past, you will find that ever since BugSquad has started, we have been making KDE "green".

Thanks

Thanks to nixeagle, who let me start this page from an unedited irc log. Also thanks to others who probably don't want to be mentioned.


KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal