python / python/cpython

`type('', (), {})__weakref__.__doc__` is inaccurate

Offen
#150,553 6 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

docs
Vorherrschende Sprache
Python
Sterne
77.2k
Forks
35.9k
PR-Merge-Kennzahlen
PR-Kennzahlen ausstehend

Beschreibung

Documentation

The __weakref__ descriptor on an instance of user-defined classes is a weak reference (singular instance of weakref.ReferenceType, preferring the unique one with no callback passed to the constructor if it exists and the most recently created one if not in case of multiple, and None otherwise. However, it is documented as a "list of weak references to the object".

Linked PRs
  • gh-151581

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

Lies Objects/typeobject.c ungefähr bei Zeile 4089 und sieh dir den verlinkten PR gh-151581 an. Vergleiche die bestehende Formulierung des Deskriptors weakref mit dem im Issue beschriebenen Verhalten; die Dokumentation ist fertig, wenn sie den Deskriptor korrekt beschreibt, anstatt ihn als Liste schwacher Referenzen zu bezeichnen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
python
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
1/5
Geschätzter Aufwand
Unter einer Stunde
Aktivitätsstatus
Veraltet
Klarheit
Klar beschrieben
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

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