doc: clarify verbose option help text (#908)

cpz-research · web-flow · commit 7793c0d294e5 · 2026-06-07T20:00:05.000Z
diff --git a/src/_pytask/build.py b/src/_pytask/build.py
@@ -206,7 +206,7 @@ def build(  # noqa: PLR0913
     trace : bool, default=False
         Enter debugger in the beginning of each task.
     verbose : int, default=1
-        Make pytask verbose (>= 0) or quiet (= 0).
+        Set pytask verbosity: 0 = quiet, 1 = default, 2 = verbose.
     **kwargs : Any
         Additional configuration forwarded to pytask's configuration pipeline.
 
diff --git a/src/_pytask/parameters.py b/src/_pytask/parameters.py
@@ -70,7 +70,7 @@
     ["-v", "--verbose"],
     type=click.IntRange(0, 2),
     default=1,
-    help="Make pytask verbose (>= 0) or quiet (= 0).",
+    help="Set pytask verbosity: 0 = quiet, 1 = default, 2 = verbose.",
 )
 """click.Option: An option to control pytask's verbosity."""
 

Original file line number	Diff line number	Diff line change
`@@ -70,7 +70,7 @@`
`70`	`70`	`["-v", "--verbose"],`
`71`	`71`	`type=click.IntRange(0, 2),`
`72`	`72`	`default=1,`
`73`		`- help="Make pytask verbose (>= 0) or quiet (= 0).",`
	`73`	`+ help="Set pytask verbosity: 0 = quiet, 1 = default, 2 = verbose.",`
`74`	`74`	`)`
`75`	`75`	`"""click.Option: An option to control pytask's verbosity."""`
`76`	`76`