python / python/cpython

Docs: problem with page "__future__ — Future statement definitions"

Offen
#154,559 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

docs
Vorherrschende Sprache
Python
Sterne
77.2k
Forks
35.9k
PR-Merge-Kennzahlen
PR-Kennzahlen ausstehend

Beschreibung

Documentation

The page at https://docs.python.org/3/library/__future__.html has a problem:

"__future__.annotations | Never: PEP 563: Postponed evaluation of annotations, PEP 649: Deferred evaluation of annotations using descriptors"

This is incorrect though innit?

Isn't it "mandatory" in 3.14 - https://docs.python.org/3/reference/compound_stmts.html#annotations?

EDIT: Re-reading both the pages I think I was mistaken - but the page should still link to https://docs.python.org/3/reference/compound_stmts.html#annotations I suppose.

Linked PRs
  • gh-154608

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

Vergleiche den Eintrag future.annotations auf der Dokumentationsseite zu future mit dem aus der Sprachreferenz verlinkten Abschnitt zu annotations. Die gemeldete Korrektur besteht darin, diesen Referenzlink hinzuzufügen, falls dies angebracht ist; das Issue gh-154608 ist bereits verlinkt, also prüfe seinen Status, bevor du beginnst.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
python
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
1/5
Geschätzter Aufwand
Unter einer Stunde
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
25/100

Neue Issues direkt in Ihr Postfach

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