Dies ist eine leicht bearbetete Kopie der online verfügbaren Anleitung des Subversion Prokjekts, an neue Benutzer darüber wie Fehler gemeldet werden sollen. Siehe „Behandeln Sie Jeden Nutzer, Wie Einen Möglichen Freiwilligen“ im Kapitel Kapitel 8, Leitung von Freiwilligen welches behandelt, warum es wichtig ist, dass ein Projek solche Anleitungen hat. Das ursprüngliche Dokument befindet sich bei http://svn.collab.net/repos/svn/trunk/www/bugs.html.

                   Meldung von Fehlern in Subversion

Dieses Dokument handelt darüber wie und wo Fehler gemeldet werden
sollen. (Es ist keine Liste aller noch bestehender Fehler — welches Sie
statt dessen hier bekommen können.)

Wo man einen Fehler melden soll.
---------------------

    * Wenn der Fehler in Subversion selber ist, senden Sie eine Email an
      users@subversion.tigris.org. Sobalt es als Fehler bestätigt wird,
      kann jemand, vielleicht du, es in das Ticket System eingeben.
      (Oder wenn Sie sich ziemlich sicher darüber sind, können Sie auch
      gleich an unseren Entwickler Verteiler schreiben, 
      dev@subversion.tigris.org. Wenn du dir aber nicht sicher bits, ist
      es besser wenn du zuerst an users@ schreibst; dort kann dir jemand
      sagen, ob das Verhalten, dass du beobachtet hast richtig ist oder
      nicht.)

    * Wenn der Fehler in der APR Bibliothek ist, melde es bitte bei
      einem dieser Verteiler: dev@apr.apache.org, 
      dev@subversion.tigris.org.

    * Wenn der Fehler in der Neon HTTP Bibliothek ist, melde es bitte
      bei: neon@webdav.org, dev@subversion.tigris.org.

    * Wenn der Fehler in Apache HTTPD 2.0 ist, melde es bitte an beide
      der folgenden Verteiler: dev@httpd.apache.org,
      dev@subversion.tigris.org. Der Apache httpd Entwickler Verteiler
      hat einen hohen Betrieb, es ist also möglich, dass deine Meldung
      übersehen wird. Du kannst auch eine Bug Meldung bei 
      http://httpd.apache.org/bug_report.html einreichen.

    * If the bug is in your rug, please give it a hug and keep it snug.



Wie man einen Bug meldet
-------------------

Vergewissere dich erst, dass es ein Fehler ist. Wenn Subversion sich
nicht so verhällt wie du es erwartest, schaue in der Dokumentation und
den Archiven der Email Verteiler nach beweisen, dass es sich so
verhalten sollte wie du es erwartest. Wenn es natürlich etwas
offensichtliches ist, wie wenn Subversion eben deine Daten zerstört hat
und deine Bildschirm dazu gebracht hat Rauch auszuspucken, dann kannst
du deinem Urteil vertrauen. Wenn du dir aber nicht sicher bist, frage
lieber zuerst bei dem Email Verteiler für Nutzer nach, 
users@subversion.tigris.org, oder frage im IRC bei #svn auf 
irc.freenode.net nach.

Wenn dir dann sicher bist, dass es ein Fehler ist, ist das wichtigste
was du machen kannst, dir eine einfache Beschreibung und eine Anleitung
wie der Fehler reproduziert weden kann auszudenken. Wenn der Fehler als 
du ihn ursprünglich gefunden hast, fünf Dateien über zehl Commits
brauchte, versuche es mit nur einer Datei und einem Commit zu
verursachen. Je einfacher die Anleitung, desto wahrscheinlicher wird ein
Entwickler es erfolgreich reproduzieren und beheben können.

Wenn du die Anleitung schreibst, erkläre nicht einfach in Worten, was du
gemacht hats um den Fehler zu bekommen. Schreibe statt dessen ein
genaues Protokoll, welche Befehle du eingegeben hast und was sie
ausgegeben haben. Du solltes das über Kopieren und einfügen machen. Wenn
Dateien dafür gebraucht werden, solltest du die Namen der Dateien
angeben, und sogar ihren Inhalt, wenn du meist die wäre relevant. Am
besten ist es, wenn du deine Anleitung als Skript zusammenschnürst, das
hilft ungemein.

Nur kurz um etwas aus dem Weg zu räumen: Du *hast* doch die
neuste Version, oder? :-) Der Fehler wurde vielleicht schon behoben; du
solltest deine Anleitung bei der aktuellen Entwickler Version von
Subversion ausprobieren.

Zusätzlich zu der Anleitung für die Reproduktion, brauchen wir auch eine
komplette Beschreibung der Umgebung in der du den Fehler reproduziert
hast. Das heißt:

    * Dein Betriebssystem 
    * Die Version und/oder Revision von Subversion
    * Der Compiler und die Einstellungen die du benutzt hast um dein
      Build von Subversion zu machen.
    * Irgend welche Änderungen an Subversion die du vorgenommen hast.
    * Die Version von Berkeley DB die du mit Subversion benutzt, wenn
      überhaupt 
    * Alles andere, was möglicherweise relevant sein könnte. Wobei du
      lieber zuviel Informationen geben solltest, als zu wenige.

Wenn du das alles gemacht hast, bist du bereit die Meldung zu schreiben.
Fange mit einer Klaren beschreibung des Fehlers an. D.h. sage, wie du
erwartest, dass sich Subversion verhalten sollte, und im Gegensatz dazu
wie es sich wirklich verhalten hat. Auch wenn der Fehler dir
offensichtlich erscheint, muss es das nicht unbeningt für jemand anderes
sein, es ist also am besten ein Ratespiel zu vermeiden. Danach solltest
du die Beschreibung der Umgebung und die Anleitung angeben. Wenn du auch
eine Spekulation über die Ursache machen willst, und sogar einen Patch
um den Fehler zu beheben, wäre das Super — siehe 
http://svn.collab.net/repos/svn/trunk/www/hacking.html#patches für eine
Anleitung, darüber wie Patches eingereicht werden sollten.

Schreibe all diese Informationen an dev@subversion.tigris.org, oder wenn
du bereits dort gewesen bist und darum gebeten wurdest einen Ticket auf
zu machen, gehe direkt zu den Ticket Tracker und folge dort der
Anleitung.

Danke. Wir wissen, dass es eine Menge Arbeit ist eine effektive Bug
Meldung zu schreiben, eine gute Meldung kan aber Stunden Arbeit für
einen Entwickler sparen, und der Fehler wird viel eher behoben.