dev: clarifies and homogenizes formatter descriptions (#5265)

Author: ldez

pkg/golinters/gci/internal/analyzer.go

@@ -44,7 +44,7 @@ func NewAnalyzer() *analysis.Analyzer {
 
 	a := &analysis.Analyzer{
 		Name:     "gci",
-		Doc:      "A tool that control Go package import order and make it always deterministic.",
+		Doc:      "Checks if code and import statements are formatted, it makes import statements always deterministic.",
 		Run:      runAnalysis,
 		Requires: []*analysis.Analyzer{inspect.Analyzer},
 	}

pkg/golinters/gofmt/gofmt.go

@@ -23,8 +23,7 @@ func New(settings *config.GoFmtSettings) *goanalysis.Linter {
 
 	return goanalysis.NewLinter(
 		linterName,
-		"Gofmt checks whether code was gofmt-ed. By default "+
-			"this tool runs with -s option to check for code simplification",
+		"Checks if the code is formatted according to 'gofmt' command.",
 		[]*analysis.Analyzer{analyzer},
 		nil,
 	).WithContextSetter(func(lintCtx *linter.Context) {

pkg/golinters/gofumpt/gofumpt.go

@@ -44,7 +44,7 @@ func New(settings *config.GofumptSettings) *goanalysis.Linter {
 
 	return goanalysis.NewLinter(
 		linterName,
-		"Gofumpt checks whether code was gofumpt-ed.",
+		"Checks if code and import statements are formatted, with additional rules.",
 		[]*analysis.Analyzer{analyzer},
 		nil,
 	).WithContextSetter(func(lintCtx *linter.Context) {

pkg/golinters/goimports/goimports.go

@@ -24,8 +24,7 @@ func New(settings *config.GoImportsSettings) *goanalysis.Linter {
 
 	return goanalysis.NewLinter(
 		linterName,
-		"Check import statements are formatted according to the 'goimport' command. "+
-			"Reformat imports in autofix mode.",
+		"Checks if the code and import statements are formatted according to the 'goimports' command.",
 		[]*analysis.Analyzer{analyzer},
 		nil,
 	).WithContextSetter(func(lintCtx *linter.Context) {
@@ -56,7 +55,7 @@ func runGoImports(lintCtx *linter.Context, pass *analysis.Pass) error {
 
 		err = internal.ExtractDiagnosticFromPatch(pass, file, string(diff), lintCtx)
 		if err != nil {
-			return fmt.Errorf("can't extract issues from gofmt diff output %q: %w", string(diff), err)
+			return fmt.Errorf("can't extract issues from goimports diff output %q: %w", string(diff), err)
 		}
 	}