docs(cli): clarify relationship between --verbose and --verbosity
Metadata
Current evaluation
PR #424 clarified --verbose as equivalent to --verbosity=verbose but was closed unmerged; mr-cal said internal DE028 guidance requires different wording and the effort was paused pending better internal UX guidance.
Resolution: closed stale
Reason: Maintainer mr-cal closed the PR without merging, stating the help text is driven by an opaque internal Canonical process (DE028) whose current guideline is 'worse than what we have now', and that the effort would be abandoned until better internal guidance exists. No commit or superseding PR landed.
Evaluated by: mr-cal-bot
No scores available.
Issue body
Clarify the relationship between `--verbose` and `--verbosity`.
Previously the help text for `--verbose` was ambiguous when used together
with `--verbosity`. This change clarifies that `--verbose` is equivalent
to `--verbosity=verbose`.
The related unit test has been updated accordingly.
Context: canonical/snapcraft#5097
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed stale | PR #424 clarified --verbose as equivalent to --verbosity=verbose but was closed unmerged; mr-cal said internal DE028 guidance requires different wording and the effort was paused pending better internal UX guidance. | |
| stealth/space-bunny-alpha | — | closed stale | canonical/craft-cli#424 was closed unmerged after the proposed --verbose wording conflicted with internal DE028 guidance; work was paused pending better guidance. | |
| qwen/qwen3.6-35b-a3b | — | — | Abandoned. Maintainers cited conflicting internal documentation guidelines and decided to pause the effort until better internal guidance is established. No changes were merged. |
Update history
No update history recorded yet.
Related work
-
Blocked By:
canonical/snapcraft#5097
(confidence 70%)
The originating snapcraft issue citing this PR as the upstream fix; still open and blocked on internal Canonical UX guidance.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #5097 [doc] Clarify the difference between `-v` and `--verbosity` in help messages | snapcraft | open | Help-text clarity request: -v/--verbose vs --verbosity overlap confusingly. Triaged and acknowledged by mr-cal; fix lives upstream in craft-cli, where PR #424 was closed unmerged, so blocked on internal Canonical UX guidance. |