python / python/typing

Best Practices document

Offen
#851 3 Kommentare 2 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

topic: documentation
Vorherrschende Sprache
Python
Sterne
1.8k
Forks
302
Ø Merge
23 Std.
Gemergte PRs (30 T.)
8

Beschreibung

  • Built-in generics
  • New union syntax
  • No union return types, use Any or T | Any
  • Discuss Any vs object
  • Callbacks: Use return type object instead of None or Any if the returned value is ignored

Please add anything you think the document should contain.

Beitragsleitfaden

Für dieses Repository ist kein Beitragsleitfaden indexiert

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

Beginne mit den in diesem Issue vorgeschlagenen Themen und prüfe zunächst die vorhandene Typisierungsdokumentation des Repositorys, bevor du entscheidest, wo ein Best-Practices-Dokument hingehört. Bestätige die Richtlinien für eingebaute Generics, Union-Syntax, Rückgabetypen, Any gegenüber object und Callbacks, und lege anschließend gemeinsam mit den Projekt-Maintainern den Umfang des Dokuments und die Kriterien für den Abschluss fest.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
python
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Veraltet
Klarheit
Muss geklärt werden
Anfängerfreundlichkeit
30/100

Neue Issues direkt in Ihr Postfach

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