Hantering av buggar¶
Python är ett moget programmeringsspråk som har etablerat ett rykte om stabilitet. För att upprätthålla detta rykte vill utvecklarna gärna veta om du hittar några brister i Python.
Det kan ibland vara snabbare att fixa buggar själv och bidra med patchar till Python eftersom det effektiviserar processen och involverar färre personer. Lär dig hur du bidrar.
Dokumentationsbuggar¶
Om du hittar ett fel i den här dokumentationen eller vill föreslå en förbättring, skicka in en felrapport på issue tracker. Om du har ett förslag på hur felet kan åtgärdas, bifoga det också.
Du kan också öppna ett diskussionsämne på vårt Documentation Discourse forum.
Om du hittar en bugg i temat (HTML / CSS / JavaScript) i dokumentationen, skicka en buggrapport på python-doc-theme issue tracker.
Se även
- Documentation bugs
En lista över dokumentationsbuggar som har skickats in till Pythons problemspårare.
- Ärendehantering
Översikt över processen för att rapportera en förbättring på spåraren.
- Hjälp med dokumentation
Omfattande guide för personer som är intresserade av att bidra till Python-dokumentationen.
- Dokumentationsöversättningar
En lista över GitHub-sidor för översättning av dokumentation och deras primära kontaktpersoner.
Använda Pythons ärendehanterare¶
Problemrapporter för Python själv bör skickas in via GitHub issues tracker (https://github.com/python/cpython/issues). GitHub issues tracker erbjuder ett webbformulär som gör det möjligt att mata in relevant information och skicka den till utvecklarna.
Det första steget i en rapport är att ta reda på om problemet redan har rapporterats. Fördelen med att göra det, förutom att spara utvecklarnas tid, är att du får veta vad som har gjorts för att åtgärda det; det kan vara så att problemet redan har åtgärdats till nästa version, eller så behövs ytterligare information (i vilket fall du är välkommen att tillhandahålla den om du kan!). För att göra detta, sök i spåraren med hjälp av sökrutan längst upp på sidan.
Om det problem du rapporterar inte redan finns i listan loggar du in på GitHub. Om du inte redan har ett GitHub-konto skapar du ett nytt konto genom att använda länken ”Registrera dig”. Det är inte möjligt att skicka in en felrapport anonymt.
När du nu är inloggad kan du skicka in ett ärende. Klicka på knappen ”Nytt ärende” i det övre fältet för att rapportera ett nytt ärende.
Inlämningsformuläret har två fält, ”Title” och ”Comment”.
I fältet ”Title” skriver du en mycket kort beskrivning av problemet; mindre än tio ord är bra.
I fältet ”Kommentar” beskriver du problemet i detalj, inklusive vad du förväntade dig skulle hända och vad som hände. Var noga med att ange om några tilläggsmoduler var inblandade och vilken maskin- och programvaruplattform du använde (inklusive versionsinformation i förekommande fall).
Varje problemrapport kommer att granskas av en utvecklare som avgör vad som behöver göras för att åtgärda problemet. Du kommer att få en uppdatering varje gång en åtgärd vidtas för att lösa problemet.
Se även
- Så här rapporterar du buggar på ett effektivt sätt
Artikel som går in i detalj på hur man skapar en användbar felrapport. Här beskrivs vilken typ av information som är användbar och varför den är användbar.
- Riktlinjer för Bug Writing
Information om hur man skriver en bra felrapport. En del av detta är specifikt för Mozilla-projektet, men beskriver allmän god praxis.
Kom igång med att själv bidra till Python¶
Utöver att bara rapportera buggar som du hittar är du också välkommen att skicka in patchar för att åtgärda dem. Du kan hitta mer information om hur du kommer igång med att patcha Python i Python Developer’s Guide. Om du har frågor är core-mentorship mailing list en vänlig plats för att få svar på alla frågor som rör processen för att åtgärda problem i Python.