wiki:ITERATION_12/Release/UserDocumentation/01_PreReleaseSophie/03_ReportingBugs
Last modified 15 years ago Last modified on 05/04/10 20:55:06

Reporting bugs

If you've found a bug in Sophie, we'd love it if you send it to us. Some bugs bring up the Sophie crash reporter window, which will include internal information from Sophie about the crash. But not all bugs bring up errors. If you're having a problem that doesn't actually crash Sophie, you can email Dan Visel at dan@sophiecommons.org with a description of the problem. That email address can also be used in Google chat if you have a more complicated problem that you'd like to discuss.

Bugs can also be discussed on the Sophie 2 user list or the developer list as well as in the forums of this site.

The bug-reporting interface

When a serious bug occurs, the bug tracking window should appear. It looks like this:

source:/trunk/sophie2-platform/doc/app-help/images/ReportBugWindow.png

This can also be triggered when an error has not occurred; you can choose Help > Send an Error Report to bring up this window.

This window doesn't automatically send a bug report to the Sophie developers; you need to click Send to do that. You should be aware that choosing to use the error-reporting window may transmit minor amounts of personal information (like the name of the directories on your hard drive) to Sophie's developers. If you're worried about this, use of internal bug reporting is entirely voluntary, and if you do not email anything to us, your personal information will not be transmitted. But sending in error reports will help us make Sophie better.

If you are willing to send this information, here's what to do:

  1. First, you first need to fill in your email address.
  2. Fill in some basic information about what you did that caused the error in the bottom field. If there's a particular sequence of events that triggers the bug, listing that sequence will be very helpful.
  3. If a particular piece of media or book that always causes the error, you can attach that. This isn't always necessary.
  4. Finally, click the Send button.

That's it. If we have questions, we'll email you back for details.