python / python/peps

Whole-document visible deprecation

Offen
#2,719 13 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

infra meta
Vorherrschende Sprache
reStructuredText
Sterne
5k
Forks
1.8k
Ø Merge
2 T. 4 Std.
Gemergte PRs (30 T.)
25

Beschreibung

While discussing the question of updating or superseding/deprecating PEPs, it occurred to me that it would probably be a good idea to display PEPs that aren't active (have been superseded, rejected or otherwise no longer apply) in a way that their status is more apparent than just the one header line at the top, or (like PEP 302) a single note section at the top. If we could have a background text, background colour, floating notice on the side or any kind of visual indication that the text is not authoritative (anymore) even when following a direct link to a section in the PEP, that would be great.

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Das Issue nennt keine Dateien, Tests oder Einstiegspunkte; beginne damit zu ermitteln, wie PEP-Seiten gerendert werden und wie der inaktive Status dargestellt wird. Erledigt bedeutet, dass inaktive PEPs sichtbar als nicht maßgeblich gekennzeichnet sind, selbst wenn ein direkter Link einen Abschnitt öffnet.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Bereich
documentation
Issue-Typ
Feature
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Veraltet
Klarheit
Muss geklärt werden
Anfängerfreundlichkeit
25/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.