docs: improve wording about formatter as linter (#6006)

ldez · web-flow · commit bd42c921032d · 2025-08-14T13:30:26.000+02:00
diff --git a/docs/content/docs/configuration/cli.md b/docs/content/docs/configuration/cli.md
@@ -14,11 +14,13 @@ weight: 1
 {{< /cards >}}
 
 > [!NOTE]
-> The formatters explicitly defined in the configuration section [`formatters`](/docs/configuration/file/#formatters-configuration) are automatically run by the command [`golangci-lint run`](/docs/configuration/cli/#run).
+> This command executes enabled linters, and the formatters defined in [`formatters`](/docs/configuration/file/#formatters-configuration),
+> but it does not format the code.
 > 
-> You don't need to run [`golangci-lint fmt`](/docs/configuration/cli/#fmt) before [`golangci-lint run`](/docs/configuration/cli/#run)
+> To only format code, use [`golangci-lint fmt`](/docs/configuration/cli/#fmt).
+> To apply both linter fixes and formatting, use `golangci-lint run --fix`. 
 > 
-> But the formatters cannot be enabled or disabled inside the `linters` section or the flags `-E/--enable`, `-D/--disable` of the command  [`golangci-lint run`](/docs/configuration/cli/#run).
+> The formatters cannot be enabled or disabled inside the [`linters`](/docs/configuration/file/#linters-configuration) section or the flags `-E/--enable`, `-D/--disable` of the command  [`golangci-lint run`](/docs/configuration/cli/#run).
 > 
 > The formatters can be enabled/disabled by defining them inside the [`formatters`](/docs/configuration/file/#formatters-configuration) section or by using the flags `-E/--enable`, `-D/--disable` of command [`golangci-lint fmt`](/docs/configuration/cli/#fmt).
 

Original file line number	Diff line number	Diff line change
`@@ -14,11 +14,13 @@ weight: 1`
`14`	`14`	`{{< /cards >}}`
`15`	`15`
`16`	`16`	`> [!NOTE]`
`17`		-> The formatters explicitly defined in the configuration section [`formatters`](/docs/configuration/file/#formatters-configuration) are automatically run by the command [`golangci-lint run`](/docs/configuration/cli/#run).
	`17`	+> This command executes enabled linters, and the formatters defined in [`formatters`](/docs/configuration/file/#formatters-configuration),
	`18`	`+> but it does not format the code.`
`18`	`19`	`>`
`19`		-> You don't need to run [`golangci-lint fmt`](/docs/configuration/cli/#fmt) before [`golangci-lint run`](/docs/configuration/cli/#run)
	`20`	+> To only format code, use [`golangci-lint fmt`](/docs/configuration/cli/#fmt).
	`21`	+> To apply both linter fixes and formatting, use `golangci-lint run --fix`.
`20`	`22`	`>`
`21`		-> But the formatters cannot be enabled or disabled inside the `linters` section or the flags `-E/--enable`, `-D/--disable` of the command [`golangci-lint run`](/docs/configuration/cli/#run).
	`23`	+> The formatters cannot be enabled or disabled inside the [`linters`](/docs/configuration/file/#linters-configuration) section or the flags `-E/--enable`, `-D/--disable` of the command [`golangci-lint run`](/docs/configuration/cli/#run).
`22`	`24`	`>`
`23`	`25`	> The formatters can be enabled/disabled by defining them inside the [`formatters`](/docs/configuration/file/#formatters-configuration) section or by using the flags `-E/--enable`, `-D/--disable` of command [`golangci-lint fmt`](/docs/configuration/cli/#fmt).
`24`	`26`