Update function signatures to use `*` and `/` as needed
Personne n'a encore pris cette issue.
- Langage dominant
- Python
- Étoiles
- 77.2k
- Forks
- 35.9k
- Métriques de merge des PR
- Métriques de PR en attente
Description
Documentation
[!CAUTION]
For new contributors, please do not consider this issue as an "easy" one. While the changes may seem mechanical, they are not necessarily trivial as this requires to know what really happens (both at a Python and a C level).
This is tracks cases where changes need to be made to enact the Editorial Board's decision for function signature markup.
- builtins:
-
min() -
max() -
range() -
map()
-
- methods on builtins:
-
dict.get(),dict.setdefault()
-
See also:
- https://discuss.python.org/t/editorial-board-decisions/58580
- https://github.com/python/cpython/pull/129669#issuecomment-2636839784
- https://discuss.python.org/t/81003
- https://devguide.python.org/documentation/style-guide/#function-signatures
- https://discuss.python.org/t/58750
Linked PRs
- gh-131868
- gh-131886
- gh-128208
- gh-131893
- gh-131894
- gh-131990
- gh-131992
- gh-132029
- gh-136085
- gh-136120
- gh-136121
- gh-137656
- gh-137657
- gh-137902
- gh-137904
- gh-139978
- gh-140270
- gh-144856
- gh-156179
- gh-156267
- gh-156268
- gh-156269
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Piste de recherche
Commencez par l’élément map() restant qui n’est pas coché et examinez les recommandations relatives aux signatures de fonction ainsi que les discussions liées de l’Editorial Board. Consultez la documentation pertinente des fonctions intégrées et les PRs liées existantes ; le travail est terminé lorsque les signatures concernées utilisent systématiquement * et / conformément au balisage convenu.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- c, python
- Domaine
- documentation
- Type d'issue
- Documentation
- Difficulté
- 4/5
- Temps estimé
- 3-5 jours
- Activité
- À l'abandon
- Clarté
- Plutôt claire
- Accessibilité débutants
- 25/100