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 debian-edu mailing list. 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.

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

Tagging bug reports

When reporting bugs on Debian BTS, that are relevant for Debian Edu/Skolelinux, it's a good idea to tag them with our Debian Edu usertag. That makes them much easier to track. You can tag a bug with our usertag by sending an 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