Argument Clinic How-To needs more examples
Offen
Dieses Issue hat noch niemand übernommen.
type-feature
- Vorherrschende Sprache
- Python
- Sterne
- 2.1k
- Forks
- 1k
- Ø Merge
- 2 T. 12 Std.
- Gemergte PRs (30 T.)
- 12
Beschreibung
Documentation
Currently, the example for AC How-To is the method _pickle.Pickler.dump. I think it is not proper since it cannot cover all cases and makes readers confused. A more intuitive example should be considered to replace the current one.
Linked PRs
- python/cpython#106800
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Lies das Argument Clinic How-To und prüfe das aktuelle Beispiel für _pickle.Pickler.dump. Vergleiche es mit den Fällen, die der Leitfaden abdecken muss, und ersetze das Beispiel durch ein intuitiveres oder füge gegebenenfalls Beispiele hinzu; die Dokumentation sollte Leser nicht länger verwirren und die vereinbarte Änderung im verlinkten PR widerspiegeln.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- python
- Bereich
- documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 2/5
- Geschätzter Aufwand
- 1-3 Stunden
- Aktivitätsstatus
- Veraltet
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 25/100