Spec: `Final` section could use better definition for `Final` vs. `Final[X]`
Nessuno ha ancora preso questa issue.
- Lingua principale
- Python
- Stelle
- 1.8k
- Fork
- 302
- Merge medio
- 23h
- PR unite (30g)
- 8
Descrizione
Came up in #2353: Currently, the syntax section for Final uses the following definitions:
Finalmay be used in one of several forms:
- With an explicit type, using the syntax
Final[<type>][...]- With no type annotation. [...]
As @carljm points out, these definitions are not great. I suggest to give them better names and use those consistently in the spec (and elsewhere). Carl used "bare" for the latter case, which I like. Maybe "explicitly typed" for the former? "When using a bare Final ..." or "When using an explicitly typed Final ..."
Guida per i contributori
Nessuna guida per i contributori indicizzata per questo repository
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Direzione di ricerca
Inizia dalla sezione della specifica relativa alla sintassi di Final e cerca nella specifica e nella documentazione correlata le descrizioni esistenti di Final e Final[X]. Il lavoro è completato quando le due forme hanno definizioni chiare e denominate in modo coerente, che utilizzano termini come «nudo» e «tipizzato esplicitamente», senza lasciare formulazioni in conflitto altrove.
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à
- Attiva
- Chiarezza
- Abbastanza chiara
- Idoneità per principianti
- 72/100