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/cli_test.go

@@ -48,7 +48,9 @@ func writeFile(t *testing.T, path, contents string) {
 // root command has, after parsing args.
 func newCommand(t *testing.T, opts *Options, args ...string) *cobra.Command {
 	t.Helper()
-	cmd := &cobra.Command{Use: "test"}
+	cmd := &cobra.Command{
+		Use: "test",
+	}
 	opts.Bind(cmd)
 	if err := cmd.ParseFlags(args); err != nil {
 		t.Fatal(err)
@@ -203,7 +205,9 @@ func confirmWithInput(t *testing.T, input string) bool {
 
 	oldIn, oldOut := os.Stdin, os.Stdout
 	os.Stdin, os.Stdout = stdin, stdout
-	defer func() { os.Stdin, os.Stdout = oldIn, oldOut }()
+	defer func() {
+		os.Stdin, os.Stdout = oldIn, oldOut
+	}()
 
 	return Confirm("Proceed?")
 }