Programmfehler melden

Vor dem Anlegen eines Fehlerberichtes …

  • stelle sicher, dass Du den Fehler absichtlich auslösen kannst und die dazu notwendigen Schritte beschreiben kannst.
    Idealerweise verwendest Du dazu eine neue, leere Datei (die später als Testdatei von Nutzen sein kann) und probierst das Ganze auch einmal mit den Standardeinstellungen aus (Info zum Zurücksetzen der Benutzereinstellungen). So weißt Du, dass das Problem ist, was Du glaubst, und nicht mit irgendwelchen geänderten Einstellungen zusammenhängt. Wenn Du das Problem selbst nicht reproduzieren kannst, warte bitte mit dem Erstellen eines Fehlerberichtes bis Du es isoliert hast.

    Gelegentlich gibt es Fehler, die nur in einer bestimmten Datei (aber nicht in einer neuen Datei) auftreten, und auch diese sind für Entwickler von Interesse. Als Anfänger bespreche das Problem aber besser zuerst mit fortgeschrittenen Benutzern (z.B. im Forum, im Chat oder auf der Mailingliste). Für Anfänger wird allgemein empfohlen, ihr Problem zunächst mit anderen Benutzern zu konkretisieren, bevor sie einen Fehlerbericht erstellen (mehr dazu weiter unten).

  • durchsuche schon geschriebene Fehlerberichte, um sicherzustellen, dass der Fehler nicht bereits bekannt ist

    1. Bugs auf Launchpad:
      Wir haben Launchpad für viele Jahre benutzt um Fehlerberichte zu verwalten, wodurch es wahrscheinlich ist, dass das Problem dort bereits einen Eintrag hat. In früheren Berichten finden sich oftmals zusätzliche Informationen dazu. Überprüfe in jedem Fall, dass der Fehler auch in der neuesten veröffentlichten Version von Inkscape auftritt. Falls ja, bitten wir Dich darum uns mit dem übertragen des Berichts nach GitLab zu helfen, wo wir in Zukunft alle Fehlerberichte verwalten. Versuche die technischen Details des Eintrags so gut wie möglich zusammenzufassen. Halte die Beschreibung kurz aber präzise und füge einen Link zum alten Eintrag auf Launchpad ein.

    2. Bugs auf GitLab (siehe Hinweise und Link weiter unten):
      Versuche absolut sicherzustellen, dass der Fehler nicht bereits berichtet wurde bevor Du einen neuen Eintrag dafür erstellstbzw. einen bereits existierenden überträgst. Wenn ein Fehlerbericht bereits existiert, dann füge einfach einen neuen Kommentar zum bestehenden Eintrag hinzu, in dem Du alle zusätzlichen und möglicherweise hilfreichen Informationen zusammenfasst, die Du beisteuern kannst. Wenn Du verdeutlichen möchtest, dass ein Bericht für Dich von besonderer Bedeutung ist, dann zeige stattdessen Deine Zustimmung, indem du eines der kleinen Abstimmungs-Symbole unterhalb der Fehlerbeschreibung verwendest. (Vermeide "Ich auch!" Kommentare, denn diese erschweren es den Entwicklern die technischen Informationen eines Eintrags zu finden).
      Solltest Du ähnliche Fehlerberichte finden, hilfst du uns mitunter auch gewaltig, indem du diese gegenseitig verlinkst. Solltest Du trotzdem einen neuen Eintrag erstellen, beschreibe genau wie sich Dein Problem von den in existierenden Berichten beschriebenen unterscheidet.

Jeder Fehlerbericht sollte mindestens folgende Informationen beinhalten:

  • eine präzise Fehlerbeschreibung auf Englisch (d.h. kompakt und korrekt, aber mit so vielen Details wie möglich) mit:

    • einer Schritt-für-Schritt-Anleitung, die verlässlich zum Fehler führt
    • einer Beschreibung des Programmverhaltens
    • einer Beschreibung des erwarteten Programmverhaltens
    Wenn Du mehr darüber lernen möchtest, wie man einen "guten" Fehlerbericht schreibt, mit dem Entwickler etwas anfangen können, schau Dir einmal den Artikel "How to Report Bugs Effectively" von Simon Tatham (Autor von PuTTY) an.
  • die verwendete Inkscapeversion (siehe Menü: Hilfe > Über Inkscape, z.B. "Inkscape 0.92.3 (2405546, 2018-03-11)")
    Liste auch alle Vorversionen auf, in denen das Problem schon bestand - und auch alle Versionen, in denen das Problem nicht auftrat, wenn Du dazu Informationen hast.

  • das verwendete Betriebssystem

Folgende Informationen können den Entwicklern zusätzlich dabei helfen, einen Fehler schneller zu beheben:

  • eine Testdatei im SVG-Format, in der nur das enthalten ist, was für das Problem relevant ist, und sonst nichts (kleinstmögliches Beispiel)
  • dieselbe Datei in einem anderen Dateiformat, falls es bei dem Problem um das Öffnen, Speichern als, Importieren oder Exportieren von anderen Dateiformaten als SVG geht

  • Bildschirmfotos, Videos oder Animationen, in denen man sehen kann, wie sich das Problem äußert, insbesondere dann, wenn eine Testdatei keinen Sinn macht oder nicht ausreicht, um das ganze Problem darzustellen. Vorher-Nachher-Bildschirmfotos können ebenfalls hilfreich sein.
  • die Sprache, in der Inkscape und das Betriebssystem verwendet werden (insbesondere dann, wenn es beim Fehlerbericht um Übersetzungen, Sonderzeichen in Dokumenten/Dateiname o.ä. geht)
  • die Installationsmethode und eine genaue Angabe der Version des Installers, falls das Problem mit der Installation, Aktualisierung oder dem Starten von Inkscape zu tun hat

Wozu werden so viele Informationen benötigt?

Entwickler müssen das Problem bei sich reproduzieren können, bevor sie versuchen können, es zu reparieren. Einige Programmfehler in Inkscape treten nur in bestimmten Versionen oder unter bestimmten Betriebssystemen auf (oder bei bestimmten Kombinationen derselben), manchmal sogar nur bei bestimmten Sprachen. Auch wenn eine Testdatei nicht immer zwingend notwendig ist, und manchmal auch gar nicht sinnvoll wäre, so kann alles, was derjenige der den Fehler meldet, an zusätzlichen Informationen bereitstellt, den Entwicklern dabei helfen, das Problem zu lösen.

Alle Inkscape-Entwickler sind Ehrenamtliche. Sie arbeiten in ihrer Freizeit, nach der Arbeit / Freizeit / Zeit mit der Familie und neben allen anderen Verpflichtungen, die sie haben, an Inkscape. Alles, was Du tun kannst, um ihnen Zeit zu sparen und es ihnen leichter zu machen, erhöht die Wahrscheinlichkeit, dass der Fehler behoben werden kann.

Weitere Pflichten nach dem Melden eines Fehlers

  • Sei bereit, auf Fragen der Entwickler zum Fehlerbericht zu antworten.
    Du bekommst eine E-Mail, wenn jemand einen Kommentar zu Deinem Fehlerbericht verfasst, oder dessen Kategorien ändert. Es kann sein, dass Du gebeten wirst, etwas näher zu erläutern oder andere Dateien, Bilder etc. hochzuladen. Bedenke, dass Deine Hilfe notwendig ist, um den Fehler erfolgreich zu reparieren.
  • Sei geduldig und denke positiv.
    Wenn Du einen Fehlerbericht verfasst, machst Du das wahrscheinlich, damit der Fehler behoben werden kann. Wir haben dasselbe Ziel! Da Inkscape von Freiwilligen in ihrer Freizeit entwickelt wird, kann es manchmal länger dauern, bis sich jemand um Deinen Bericht kümmern kann (die Schwankungsbreite liegt zwischen Stunden und Jahren). Versuche dennoch, so freundlich, höflich und hilfreich wie möglich aufzutreten (selbst dann, wenn die Entwickler sich - aus Deiner Sicht - etwas dämlich anstellen ;-) ), denn Menschen sind dann eher motiviert, daran zu arbeiten und das Problem wird eventuell schneller behoben werden.

Einen Fehlerbericht verfassen oder neue Funktionen vorschlagen

Bitte berichte alle neuen Fehler, die Du in der aktuellen Version von Inkscape findest, im neuen benutzerorientierten GitLab-Bugtracker für Inkscape.

Hinweis: Du musst ein Benutzerkonto auf GitLab erstellen, um Kommentare verfassen oder neue Fehlerberichte erstellen zu können.

Wenn Du gerade erst angefangen hast, Inkscape zu verwenden, und auch, wenn Du schon ein paar Erfahrungen gesammelt hast, kann es sinnvoll sein, das Problem zunächst in einer der Mailinglisten (Entwickler- oder Benutzermailingliste) oder in einem der Foren (Liste) zu beschreiben, um das Problem zu verstehen. Eine weitere Möglichkeit sind die beiden IRC-Kanäle. Erfahrene Benutzer werden oftmals dabei helfen können, zu unterscheiden, ob es sich um einen bereits bekannten Fehler oder überhaupt um einen Fehler handelt.  Falls der Fehler schon bekannt ist, kannst Du eventuell auch mehr darüber herausfinden, und über das Gespräch Möglichkeiten finden, ihn zu umgehen, bis er repariert werden kann.

Neue Funktionen oder Feature-Wünsche können auch über den Bugtracker eingereicht werden. Als neuer Inkscapebenutzer macht es aber auch hier Sinn, zunächst mit anderen über Deine Idee zu reden, um zu verstehen, wie Dein Wunsch mit den Plänen der Entwickler für Inkscape zusammenpasst, bevor Du einen Fehlerbericht verfasst.