Umgang mit Fehlern¶
Python ist eine ausgereifte Programmiersprache, die sich einen Ruf für Stabilität erworben hat. Um diesen Ruf aufrechtzuerhalten, möchten die Entwickler über jede von Ihnen gefundene Unzulänglichkeit in Python informiert werden.
Es kann manchmal schneller sein, Fehler selbst zu beheben und Patches zu Python beizusteuern, da dies den Prozess rationalisiert und weniger Personen involviert. Erfahren Sie, wie Sie mitarbeiten können.
Dokumentationsfehler¶
Wenn Sie einen Fehler in dieser Dokumentation finden oder eine Verbesserung vorschlagen möchten, reichen Sie bitte einen Fehlerbericht im Issue Tracker ein. Wenn Sie eine Idee haben, wie er behoben werden kann, fügen Sie diese ebenfalls hinzu.
Sie können auch einen Diskussionspunkt auf unserem Discourse-Forum für Dokumentationen eröffnen.
Wenn Sie einen Fehler im Theme (HTML / CSS / JavaScript) der Dokumentation finden, reichen Sie bitte einen Fehlerbericht im Issue Tracker des python-doc-theme ein.
Siehe auch
- Dokumentationsfehler
Eine Liste der an den Python Issue Tracker übermittelten Dokumentationsfehler.
- Issue Tracking
Übersicht über den Prozess der Meldung von Verbesserungen 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 Dokumentationsübersetzung und deren primäre Kontakte.
Verwendung des Python Issue Trackers¶
Fehlerberichte für Python selbst sollten über den GitHub Issues Tracker (https://github.com/python/cpython/issues) eingereicht werden. Der GitHub Issues Tracker bietet ein Webformular, das die Eingabe relevanter Informationen ermöglicht und an die Entwickler übermittelt.
Der erste Schritt bei der Einreichung eines Berichts ist die Feststellung, ob das Problem bereits gemeldet wurde. Der Vorteil davon ist nicht nur, dass die Zeit der Entwickler gespart wird, sondern Sie erfahren auch, was zur Behebung unternommen wurde; es kann sein, dass das Problem bereits für die nächste Veröffentlichung behoben wurde oder dass zusätzliche Informationen benötigt werden (in diesem Fall können Sie diese gerne bereitstellen, wenn Sie können!). Suchen Sie dazu im Tracker über das Suchfeld oben auf der Seite.
Wenn das von Ihnen gemeldete Problem noch nicht in der Liste aufgeführt ist, melden Sie sich bei GitHub an. Wenn Sie noch kein GitHub-Konto haben, erstellen Sie ein neues Konto über den Link „Sign up“. Es ist nicht möglich, einen Fehlerbericht anonym einzureichen.
Wenn Sie nun angemeldet sind, können Sie ein Issue einreichen. Klicken Sie in der oberen Leiste auf die Schaltfläche „New issue“, um ein neues Issue zu melden.
Das Einreichungsformular hat zwei Felder: „Title“ und „Comment“.
Geben Sie im Feld „Title“ eine *sehr* kurze Beschreibung des Problems ein; weniger als zehn Wörter sind gut.
Beschreiben Sie im Feld „Comment“ das Problem im Detail, einschließlich dessen, was Sie erwartet haben und was passiert ist. Stellen Sie sicher, dass Sie angeben, ob Erweiterungsmodule beteiligt waren und welche Hardware und Softwareplattform Sie verwendet haben (einschließlich Versionsinformationen, wo angebracht).
Jeder Fehlerbericht wird von einem Entwickler überprüft, der feststellt, was zur Behebung des Problems getan werden muss. Sie erhalten bei jeder Aktion, die auf das Issue angewendet wird, eine Aktualisierung.
Siehe auch
- Wie man effektiv Fehler meldet
Artikel, der detailliert beschreibt, wie man einen nützlichen Fehlerbericht erstellt. Dieser beschreibt, welche Art von Informationen nützlich ist und warum sie nützlich ist.
- Richtlinien für das Verfassen von Fehlerberichten
Informationen zum Verfassen eines guten Fehlerberichts. Ein Teil davon ist spezifisch für das Mozilla-Projekt, beschreibt aber allgemeine gute Praktiken.
Erste Schritte zur eigenen Mitarbeit an Python¶
Über das einfache Melden von Fehlern hinaus sind Sie auch herzlich eingeladen, Patches zur Behebung von Fehlern einzureichen. Weitere Informationen zum Einstieg in die Patch-Erstellung für Python finden Sie im Python Developer's Guide. Wenn Sie Fragen haben, ist die Core-Mentorship-Mailingliste ein freundlicher Ort, um Antworten auf alle Fragen im Zusammenhang mit dem Prozess der Fehlerbehebung in Python zu erhalten.