Umgang mit Fehlern
******************

Python ist eine ausgereifte Programmiersprache, die einen Ruf für
Stabilität erworben hat. Um diesen Ruf aufrechtzuerhalten, möchten die
Entwickler über alle Mängel informiert werden, die du in Python
findest.

Es kann manchmal schneller sein, Fehler selbst zu beheben und Patches
zu Python beizutragen, da dies den Prozess vereinfacht und weniger
Personen einbezieht. Erfahre, wie du beitragen kannst.


Dokumentationsfehler
====================

Wenn du einen Fehler in dieser Dokumentation findest oder einen
Verbesserungsvorschlag einreichen möchtest, melde bitte einen Fehler
im Issue-Tracker. Wenn du einen Vorschlag zur Behebung hast, füge
diesen bitte ebenfalls bei.

Wenn der Fehler oder der Verbesserungsvorschlag die Übersetzung dieser
Dokumentation betrifft, reiche den Bericht stattdessen im Repository
der Übersetzung ein.

Du kannst auch einen Diskussionsbeitrag in unserem Dokumentations-
Discourse-Forum eröffnen.

Wenn du einen Fehler im Theme (HTML / CSS / JavaScript) der
Dokumentation findest, reiche bitte einen Fehlerbericht im python-doc-
theme Issue-Tracker ein.

Siehe auch:

  Dokumentationsfehler
     Eine Liste von Dokumentationsfehlern, die im Python-Issue-Tracker
     eingereicht wurden.

  Fehlerverfolgung
     Überblick über den Ablauf beim Melden einer Verbesserung im
     Tracker.

  Mithilfe bei der Dokumentation
     Umfassender Leitfaden für Personen, die an der Mitarbeit an der
     Python-Dokumentation interessiert sind.

  Dokumentationsübersetzungen
     Eine Liste von GitHub-Seiten für die Übersetzung von
     Dokumentationen und deren Hauptkontakten.


Verwenden des Python-Issue-Trackers
===================================

Fehlerberichte für Python selbst sollten über den GitHub-Issue-Tracker
(https://github.com/python/cpython/issues) eingereicht werden. Der
GitHub-Issue-Tracker bietet ein Webformular, über das relevante
Informationen eingegeben und an die Entwickler übermittelt werden
können.

Der erste Schritt beim Einreichen eines Berichts besteht darin, zu
prüfen, ob das Problem bereits gemeldet wurde. Abgesehen davon, dass
du den Entwicklern Zeit ersparst, hast du den Vorteil zu erfahren, was
bereits zur Behebung getan wurde; möglicherweise wurde das Problem
bereits für das nächste Release behoben oder es werden zusätzliche
Informationen benötigt (die du gerne beisteuern kannst!). Durchsuche
dazu den Tracker über das Suchfeld oben auf der Seite.

Wenn das von dir gemeldete Problem noch nicht in der Liste enthalten
ist, melde dich bei GitHub an. Falls du noch kein GitHub-Konto hast,
erstelle ein neues Konto über den Link „Sign up“. Es ist nicht
möglich, einen Fehlerbericht anonym einzureichen.

Sobald du angemeldet bist, kannst du ein Issue erstellen. Klicke auf
die Schaltfläche „New issue“ in der oberen Leiste, um ein neues
Problem zu melden.

Das Formular enthält zwei Felder: „Title“ und „Comment“.

Gib in das Feld „Title“ eine *sehr* kurze Beschreibung des Problems
ein; weniger als zehn Wörter sind ideal.

Beschreibe im Feld „Comment“ das Problem ausführlich, einschließlich
dessen, was du erwartet hast und was tatsächlich passiert ist. Gib
unbedingt an, ob Erweiterungsmodule beteiligt waren und welche Hard-
und Softwareplattform du verwendet hast (einschließlich
Versionsangaben, falls zutreffend).

Jeder Fehlerbericht wird von einem Entwickler geprüft, der festlegt,
was zur Behebung des Problems getan werden muss. Du erhältst jedes Mal
eine Benachrichtigung, wenn eine Aktion zu diesem Issue durchgeführt
wird.

Siehe auch:

  Effektives Melden von Fehlern
     Ein Artikel, der detailliert beschreibt, wie man einen nützlichen
     Fehlerbericht erstellt. Er erläutert, welche Informationen
     nützlich sind und warum.

  Richtlinien zum Schreiben von Fehlerberichten
     Informationen zum Verfassen eines guten Fehlerberichts. Einige
     Punkte beziehen sich speziell auf das Mozilla-Projekt,
     beschreiben jedoch allgemein bewährte Vorgehensweisen.


Erste Schritte, um selbst zu Python beizutragen
===============================================

Neben dem reinen Melden gefundener Fehler bist du herzlich eingeladen,
Patches zur Behebung einzureichen. Weitere Informationen zu den ersten
Schritten beim Patchen von Python findest du im Python Developer's
Guide. Wenn du Fragen hast, ist die Core-Mentorship-Mailingliste eine
hilfsbereite Anlaufstelle für alle Fragen rund um das Beheben von
Problemen in Python.
