Naming, layout and comments: descriptive full-word names, one item per line in wrapped calls and literals, and doc comments on exported names

Short and single-letter names in application code become full words (tests
keep theirs). Wrapped calls, signatures and composite literals put one item
per line, and one-line function bodies are expanded. Exported names and
groups of constants get doc comments, and comments refer to the renamed
identifiers.

internal/cli/options.go

@@ -20,10 +20,10 @@ type Options struct {
 
 // Bind registers the shared flags as persistent flags on the root command cmd.
 func (o *Options) Bind(cmd *cobra.Command) {
-	pf := cmd.PersistentFlags()
-	pf.StringVarP(&o.configFile, "config", "c", "", "configuration file")
-	pf.BoolVarP(&o.debug, "debug", "d", false, "enable debug messages")
-	pf.BoolVarP(
+	flags := cmd.PersistentFlags()
+	flags.StringVarP(&o.configFile, "config", "c", "", "configuration file")
+	flags.BoolVarP(&o.debug, "debug", "d", false, "enable debug messages")
+	flags.BoolVarP(
 		&o.quiet, "quiet", "q", false, "don't report info or warning messages",
 	)
 }