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.