docs: Remove manual (default false) flag annotations

Brendan Lynchrequested to merge
bl-fix-default-values into main

Description

Removes all manual (default false) annotations from boolean flag descriptions, aligning the codebase with the GitLab CLI (glab) documentation style guide and the corrected convention in .gitlab/duo/mr-review-instructions.yaml (!3412 (merged)).

The style guide states that no default annotation is required for boolean flags whose default is false, and that pflag automatically appends (default true) for true-default booleans (so those must not be added by hand either). The previous project convention ("always state (default false)") contradicted this.

Changes:

  • Stripped (default false) from 21 flag descriptions across 9 command packages: orbit/setup, orbit/local, ci/cancel/job, whatsnew, project/prune, issue/create, skills/install, skills/update, duo/cli.
  • Regenerated the affected files under docs/source/ with make gen-docs.

No (default true) cases existed. Build, lint, generated-doc check, and all affected package tests pass.

Related issues and merge requests

Documentation

CLI command documentation was regenerated with make gen-docs; the updated files in docs/source/ are committed.

Edited by Brendan Lynch

Merge request reports