Differences between revisions 5 and 6
Revision 5 as of 2010-01-26 11:49:40
Size: 2752
Editor: ?PetterReinholdtsen
Comment: Update name of installer log files.
Revision 6 as of 2010-01-26 11:50:48
Size: 2798
Editor: ?PetterReinholdtsen
Comment: Link to bugzilla instructions.
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
This page should probably be merged with [[DebianEdu/BugReporting]]. This page should probably be merged with [[DebianEdu/BugReporting]] and
[[DebianEdu/HowTo/ReportBugsInBugzilla]]
.

This page should probably be merged with ?DebianEdu/BugReporting and ?DebianEdu/HowTo/ReportBugsInBugzilla.

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:

  • What did you do just before things went wrong? As detailed as possible, please, so that the developers and other testers are able to recreate the error.
  • What happened, including accurate notes of any error messages and so on.
  • What did you expect would happen? Why do you think what actually happened was wrong?
  • Include a copy of any relevant logfiles like /var/log/syslog. In all error situations, it's useful to include
    • /var/log/installer/*
    In addition, if there's a problem with X
    • /var/log/kdm.log

Then send the information above to the mailing lists or use Skolelinux Bugzilla. 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.

more information

http://wiki.debian.org/DebianEdu/BugReporting provides more info and should probably be merged with this page

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