python / python/docs-community

How to communicate the philosophy of type annotations in Python?

Offen
#8 7 Kommentare 4 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

discussion
Vorherrschende Sprache
Makefile
Sterne
55
Forks
26
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Beschreibung

A question from the Typing summit:

How to communicate the philosophy of type annotations in Python?

  • Beginners don't need annotations
  • "Catching bugs" is how to sell it to your engineering director :-)
  • Adding improvements like new Union to simplify the syntax

There's a nice community around typing that is responsive to ideas and thoughts.

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 damit, die Frage und den referenzierten Typing summit-Kontext zu lesen; es ist keine Dokumentationsdatei, kein Test und kein Einstiegspunkt angegeben. Kläre mit der Typing-Community die beabsichtigte Zielgruppe und das gewünschte Ergebnis der Dokumentation und halte anschließend eine gemeinsam vereinbarte Erklärung der Philosophie von Python-Typannotationen 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
25/100

Neue Issues direkt in Ihr Postfach

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