docs: improve linters page (golangci#2617)

Author: ldez

.golangci.example.yml

@@ -1058,16 +1058,29 @@ linters-settings:
 
   revive:
     # Maximum number of open files at the same time.
-    # https://github.com/mgechev/revive#command-line-flags
+    # See https://github.com/mgechev/revive#command-line-flags
     # Defaults to unlimited.
     max-open-files: 2048
+
+    # When set to false, ignores files with "GENERATED" header, similar to golint.
     # See https://github.com/mgechev/revive#available-rules for details.
+    # Default: false
     ignore-generated-header: true
-    severity: warning
-    enable-all-rules: false
-    # confidence: 0.8
-    # error-code: 0
-    # warning-code: 0
+
+    # Sets the default severity.
+    # See https://github.com/mgechev/revive#configuration
+    # Default: warning
+    severity: error
+
+    # Enable all available rules.
+    # Default: false
+    enable-all-rules: true
+
+    # Sets the default failure confidence.
+    # This means that linting errors with less than 0.8 confidence will be ignored.
+    # Default: 0.8
+    confidence: 0.1
+
     rules:
       # https://github.com/mgechev/revive/blob/master/RULES_DESCRIPTIONS.md#add-constant
       - name: add-constant

docs/src/docs/usage/linters.mdx

@@ -8,11 +8,11 @@ To see a list of supported linters and which linters are enabled/disabled:
 golangci-lint help linters
 ```
 
-## Enabled By Default Linters
+## Enabled by Default
 
 {.EnabledByDefaultLinters}
 
-## Disabled By Default Linters (`-E/--enable`)
+## Disabled by Default
 
 {.DisabledByDefaultLinters}