python / python/typing

Spec: PEP leftovers in the spec for literals

Ouverte Adaptée aux débutants
#2,355 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

topic: typing spec
Langage dominant
Python
Étoiles
1.8k
Forks
302
Merge moyen
23 h
PR mergées (30 j)
8

Description

There are some sections in the spec for literals that made sense as a rationale or look into the future in the PEP, but should be removed in the spec for conciseness, clarity, and consistency:

  • An (incomplete) list of illegal parameters for Literal. Since this immediately succeeds a positive, exclusive list of what parameters are allowed, this is just fluff and I believe the whole section should just be removed.
  • The next section is titled "Parameters at runtime" and details implementation details for Literal. These seem unnecessary for the typing spec and are in danger of getting desynched with the actual implementation.

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Ouvrez la spécification des littéraux et repérez les sections sur les paramètres illégaux et les paramètres à l’exécution mentionnées dans l’issue. Supprimez les sections consacrées à la justification et aux détails d’implémentation tout en gardant la description normative concise, puis examinez la spécification rendue pour confirmer que le contenu environnant reste clair.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
python
Domaine
documentation
Type d'issue
Documentation
Difficulté
2/5
Temps estimé
1-3 heures
Activité
Active
Clarté
Plutôt claire
Accessibilité débutants
75/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.