Tutorial offers dangerous advice about iterators: “__iter__() can just return self”

Ouverte
#52,623 16 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

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

Piste de recherche

Read the tutorial's iterator guidance and the attached issue8376.patch first; the payload does not name the documentation file. Confirm what the statement about iter() returning self implies, then update the tutorial so the advice is accurate and verify the resulting documentation wording.

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

Description

docs type-bug
BPO 8376
Nosy @birkenfeld, @rhettinger, @terryjreedy, @amauryfa, @pitrou, @merwok, @bitdancer, @andersk, @Usui22750
Files
  • issue8376.patch
  • Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.

    Show more details

    GitHub fields:

    assignee = None
    closed_at = None
    created_at = <Date 2010-04-12.06:35:57.093>
    labels = ['type-bug', '3.7', 'docs']
    title = 'Tutorial offers dangerous advice about iterators: \xe2\x80\x9c__iter__() can just return self\xe2\x80\x9d'
    updated_at = <Date 2017-07-13.12:29:41.820>
    user = 'https://github.com/andersk'
    

    bugs.python.org fields:

    activity = <Date 2017-07-13.12:29:41.820>
    actor = 'r.david.murray'
    assignee = 'docs@python'
    closed = False
    closed_date = None
    closer = None
    components = ['Documentation']
    creation = <Date 2010-04-12.06:35:57.093>
    creator = 'andersk'
    dependencies = []
    files = ['45088']
    hgrepos = []
    issue_num = 8376
    keywords = ['patch']
    message_count = 16.0
    messages = ['102918', '102951', '102955', '102961', '102963', '102966', '111155', '111196', '111197', '111198', '111201', '278638', '278640', '278641', '278805', '298280']
    nosy_count = 10.0
    nosy_names = ['georg.brandl', 'rhettinger', 'terry.reedy', 'amaury.forgeotdarc', 'pitrou', 'eric.araujo', 'r.david.murray', 'ysj.ray', 'andersk', 'Usui']
    pr_nums = []
    priority = 'low'
    resolution = None
    stage = None
    status = 'open'
    superseder = None
    type = 'behavior'
    url = 'https://bugs.python.org/issue8376'
    versions = ['Python 3.6', 'Python 3.7']
    

    Langage dominant
    Python
    Étoiles
    77.2k
    Forks
    36k
    Merge moyen
    1 j 9 h
    PR mergées (30 j)
    558

    Guide de contribution

    Ouvrir le guide de contribution

    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.

    Autres issues de python/cpython

    Toutes les issues de python/cpython

    Issues similaires

    Plus d'issues Python

    Recevez les nouvelles issues par e-mail

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