python / python/cpython

Intra-package References Documentation Incomplete

Offen
#80,108 8 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

docs type-bug
Vorherrschende Sprache
Python
Sterne
77.2k
Forks
36k
PR-Merge-Kennzahlen
PR-Kennzahlen ausstehend

Beschreibung

BPO 35927
Nosy @brettcannon, @terryjreedy, @ncoghlan, @ericsnowcurrently
Files
  • sound.zip: zip of code sample copied from documentation
  • 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 2019-02-07.04:38:30.393>
    labels = ['3.8', 'type-bug', '3.7', 'docs']
    title = 'Intra-package References Documentation Incomplete'
    updated_at = <Date 2019-02-14.00:38:19.737>
    user = 'https://bugs.python.org/ADataGman'
    

    bugs.python.org fields:

    activity = <Date 2019-02-14.00:38:19.737>
    actor = 'ADataGman'
    assignee = 'docs@python'
    closed = False
    closed_date = None
    closer = None
    components = ['Documentation']
    creation = <Date 2019-02-07.04:38:30.393>
    creator = 'ADataGman'
    dependencies = []
    files = ['48109']
    hgrepos = []
    issue_num = 35927
    keywords = []
    message_count = 7.0
    messages = ['335002', '335104', '335105', '335126', '335303', '335385', '335486']
    nosy_count = 6.0
    nosy_names = ['brett.cannon', 'terry.reedy', 'ncoghlan', 'docs@python', 'eric.snow', 'ADataGman']
    pr_nums = []
    priority = 'normal'
    resolution = None
    stage = None
    status = 'open'
    superseder = None
    type = 'behavior'
    url = 'https://bugs.python.org/issue35927'
    versions = ['Python 3.7', 'Python 3.8']
    

    Beitragsleitfaden

    Beitragsleitfaden öffnen

    Erste Schritte

    1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
    2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
    3. Forke das Repository und arbeite in einem Branch.
    4. Öffne einen Pull Request, der die Issue-Nummer nennt.

    Rechercherichtung

    Beginne damit, das verlinkte BPO-Issue 35927 zu lesen und sound.zip zu untersuchen, das aus der Dokumentation kopierte Codebeispiel. Identifiziere, welche Intra-Package-Referenzen in der relevanten Python-Dokumentation fehlen oder unvollständig sind. Als erledigt gilt die Aufgabe, wenn die Dokumentation die im Beispiel gezeigten Referenzen vollständig abdeckt und die entsprechenden Dokumentationsprüfungen erfolgreich sind.

    Vom Indexierungsmodell aus dem Issue-Text verfasst.

    Bewertung

    Tech-Stack
    python
    Bereich
    documentation
    Issue-Typ
    Dokumentation
    Schwierigkeit
    3/5
    Geschätzter Aufwand
    1-2 Tage
    Aktivitätsstatus
    Veraltet
    Klarheit
    Muss geklärt werden
    Anfängerfreundlichkeit
    35/100

    Neue Issues direkt in Ihr Postfach

    Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.