Clarify where docs fixes can be backported

Offen

#1,069 erstellt am 21.3.2023 6 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 3/5
Geschätzter Aufwand: 1-2 Tage
Anfängerfreundlichkeit: 35/100

Issue-Typ: Dokumentation
Klarheit: Muss geklärt werden
Aktivitätsstatus: Veraltet
Tech-Stack: python
Bereich: documentation, release

Rechercherichtung

Beginne mit dem verlinkten Statusschlüssel im Python Developer’s Guide und vergleiche seine Branch-Beschreibungen mit der dort formulierten docs-backport-Frage. Bestätige mit den zuständigen Maintainer:innen die Genehmigungsregeln für Dokumentationskorrekturen in Feature-, Prerelease-, Bugfix- und Security-Branches; abgeschlossen ist die Aufgabe, wenn die Seite klar angibt, wohin Änderungen an der Dokumentation zurückportiert werden können und ob die Genehmigung durch RM erforderlich ist.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

needs: decision type-bug type-feature

The status key for branches has lists of changes that can go in, and the lists look exclusive:

feature:

new features, bugfixes, and security fixes are accepted.

prerelease:

feature fixes, bugfixes, and security fixes are accepted for the upcoming feature release.

bugfix:

bugfixes and security fixes are accepted, new binaries are still released. (Also called maintenance mode or stable release)

security:

only security fixes are accepted and no more binaries are released, but new source-only versions can be released

end-of-life:

release cycle is frozen; no further changes can be pushed to it.

This makes it a bit awkward to backport docs changes, especially now that the lists are included in the tag descriptions.

AFAIK, docs fixes don't need RM approval in feature, prerelease and bugfix branches. (Security branches are locked so any change needs the RM in the loop.)
Is that right, @pablogsal @Yhg1s ?

Vorherrschende Sprache: Python
Sterne: 2.1k
Forks: 1k
Ø Merge: 2 T. 12 Std.
Gemergte PRs (30 T.): 12

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus python/devguide

Feature: Document SELinux bind-mount note for local devcontainer usage Offen

type-feature

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100

python/devguide#1879 · 1 Kommentar · Erstellt am 13.8.2026
Feature: Add Homebrew as a way to get build dependencies installed on Linux Offen

type-feature

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100

python/devguide#1791 · 2 Kommentare · 1 Reaktion · Erstellt am 20.4.2026
Feature: Add instructions about JIT builds Offen

topic-building python type-feature

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 65/100

python/devguide#1620 · 1 Kommentar · Erstellt am 02.8.2025
Update test command on dev guide landing page Offen

needs: decision topic-test type-bug

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100

python/devguide#1171 · 10 Kommentare · Erstellt am 29.9.2023
Explain how to revert maintenance branch commits Offen

topic-dev process type-feature

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 62/100

python/devguide#319 · 4 Kommentare · 3 Reaktionen · Erstellt am 30.1.2018

Alle Issues in python/devguide