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.