Update reference/generics.html with PEP695 type parameter syntax
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Python
- Sterne
- 1.8k
- Forks
- 302
- Ø Merge
- 23 Std.
- Gemergte PRs (30 T.)
- 8
Beschreibung
The typing documentation for generics is somewhat inconsistent in the use of new syntax:
-
Generics — typing documentation (https://typing.python.org/en/latest/reference/generics.html) doesn’t include the new syntax class Foo[T] at all
-
Generics — typing documentation (https://typing.python.org/en/latest/spec/generics.html) does, and mentions PEP695
Are there any plans on updating reference/generics.html? It is a bit confusing for someone who is using Python 3.12 or newer to see out-of-date information.
Beitragsleitfaden
Für dieses Repository ist kein Beitragsleitfaden indexiert
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginne mit reference/generics.html und vergleiche die dortigen Hinweise zu Generics mit spec/generics.html, insbesondere das Material zu PEP 695 und die Syntax class Foo[T]. Aktualisiere die Referenzseite so, dass ihre Behandlung der generischen Syntax mit der Spezifikation konsistent ist, und überprüfe anschließend die gerenderte Dokumentation auf übereinstimmende Beispiele und Formulierungen.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- python
- Bereich
- documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 2/5
- Geschätzter Aufwand
- 1-3 Stunden
- Aktivitätsstatus
- Ruhig
- Klarheit
- Klar beschrieben
- Anfängerfreundlichkeit
- 76/100