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.

It can be sometimes faster to fix bugs yourself and contribute patches
to Python as it streamlines the process and involves less people.
Learn how to contribute.


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

If you find a bug in this documentation or would like to propose an
improvement, please submit a bug report on the tracker.  If you have a
suggestion on how to fix it, include that as well.

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

If you find a bug in the theme (HTML / CSS / JavaScript) of the
documentation, please submit a bug report on the python-doc-theme bug
tracker.

If you're short on time, you can also email documentation bug reports
to docs@python.org (behavioral bugs can be sent to python-
list@python.org). 'docs@' is a mailing list run by volunteers; your
request will be noticed, though it may take a while to be processed.

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.
