Tips regarding bug reports

Guidelines for providing effective bug reports

Author: Ragnar Wisløff < ragnar at wisloff dot no >

The mailing lists get quite a few questions about why things don't work. From a developer's point of view, these questions are quite often incomplete. When that's the case, it takes more time to find a solution, because additional rounds of Q&A must take place before the necessary information has been collected and a developer or another user is able to provide a useful and sufficient answer.

In addition, it is always of great interest to the developers to get to know how the new or changed functionality actually works (or doesn't work). The hardware available to us for testing is limited. Therefore, it's very important that people other than the developers themselves use and test Skolelinux on as many types of computers as possible, running as many types of installations as possible. But it is also of utmost importance to provide thorough feedback from doing and running these installations, so that we may know what happened.

Below is a list of the information we must have in order to be able to help those in need:

Then send the information above to the mailing lists. Please do this in English, if at all possible, as this allows all developers to help, instead of only those that speak your local language.

To all people who report on test installations, we also ask that the logs mentioned above be made available. Feel free to send them as email attachments, or put them on a website you have access to and send us the URL. If you do not have an network connection on the machine where Skolelinux is installed, you may copy the logs to a diskette and move them to a machine connected to the Net.

As a rule, it's unlikely you provide too much information.

Bug reporting

The Linux distribution SkoleLinux is based heavily on Debian and DebianEdu work (or to credit rightfully: the DebianEdu work is a distilled result of work done in the SkoleLinux community!).

But SkoleLinux moves in an own pace, so some packages are newer than officially released in Debian, some are older, and some are adjusted a bit for special SkoleLinux needs.

Bugs should be filed against the Debian BTS when appropriate, to minimize the coordination needed to resolve.

Some Debian maintainers love feedback, even from external derived use of their packages. Others want only to deal strictly with Debian.

When reporting bugs on Debian BTS, that are relevant for Skolelinux, it's a good idea to tag them with our Skolelinux usertag That makes them much easier to track. You can tag a bug with our usertag by sending a email to request@bugs.debian.org with contents like this

user debian-edu@lists.debian.org
usertag 123456 + debian-edu
thanks

You can tag multiple bugs in each email by just adding usertag lines.

You can also usertag bugs when you create them, by adding headers like this:

User: debian-edu@lists.debian.org
Usertags: debian-edu

German Version is here http://www.skolelinux.de/wiki/BugReporting

more information

http://wiki.debian.org/DebianEdu/HowTo/BugPriority+Severity provides more info how we treat bug.