Specify default values for all documented parameters

Offen
#149 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Anfängerfreundlichkeit
55/100
Issue-Typ
Dokumentation
Klarheit
Größtenteils klar
Aktivitätsstatus
Aktiv
Tech-Stack
python
Bereich
documentation

Rechercherichtung

Start with the function docstrings in the cf-plot Python package, using the width=0.02 example from the issue as a model. Look for parameters that default to None and get their real value from an if not <kwarg> check in the function body, and note each actual default. Done when every documented parameter states its default value in its docstring, matching what the code does.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

docs enhancement

There is currently mostly no indication of default values for the documented parameters in the function docstrings, and though in some cases this can be implied by the function signature (e.g. width=0.02), this isn't often a clue since in lots of cases the defaults are set after an if not <kwarg> check for None values. As per good (and indeed expected) docstring practice these should be added so the user knows what default value is used by the logic.

Vorherrschende Sprache
Python
Sterne
21
Forks
11
Ø Merge
2 T. 2 Std.
Gemergte PRs (30 T.)
10

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus NCAS-CMS/cf-plot

Alle Issues in NCAS-CMS/cf-plot

Ähnliche Issues

Weitere Issues zu Python

Neue Issues direkt in Ihr Postfach

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