python / python/cpython

`_CallableGenericAlias` class and `typing.Callable` docstring should be corrected

Aperta
#145,602 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

docs topic-typing
Lingua principale
Python
Stelle
77.2k
Fork
35.9k
Metriche di merge delle PR
Metriche PR in attesa

Descrizione

Documentation

*Notes:

  • Python 3.14.3
  • Related: #145577

_CallableGenericAlias class should be corrected for example:

Represent `Callable[argtypes, resulttype]`. -> Represent `Callable[paramtypes, returntype]`.

t_args, t_result = args -> t_params, t_return = args

typing.Callable docstring should be corrected for example:

a function that takes a single parameter -> a function that has a single parameter

... to indicate optional or keyword arguments; -> ... to indicate optional or keyword parameters;
Linked PRs
  • gh-145598

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Inizia cercando _CallableGenericAlias e la docstring di typing.Callable nell’implementazione di typing di CPython. Verifica la formulazione rispetto agli esempi nell’issue, quindi verifica che entrambe le descrizioni usino la terminologia richiesta per i parametri e i valori restituiti; nota che l’issue fa riferimento alla PR collegata gh-145598.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
python
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.