docs: update documentation assets

.golangci.reference.yml

@@ -2137,6 +2137,8 @@ linters:
         - newexpr
         # Suggest replacing omitempty with omitzero for struct fields.
         - omitzero
+        # Remove obsolete //+build comments.
+        - plusbuild
         # Replace 3-clause for loops with for-range over integers.
         - rangeint
         # Replace reflect.TypeOf(x) with TypeFor[T]().
@@ -2147,6 +2149,8 @@ linters:
         - slicessort
         # Use iterators instead of Len/At-style APIs.
         - stditerators
+        # Replace strings.Index etc. with strings.Cut.
+        - stringscut
         # Replace HasPrefix/TrimPrefix with CutPrefix.
         - stringscutprefix
         # Replace ranging over Split/Fields with SplitSeq/FieldsSeq.
@@ -2378,6 +2382,12 @@ linters:
       # Default: false
       enable-all-rules: true
 
+      # By default, the default rules are enabled,
+      # but if you explicitly define or configure a rule, the default rules will be disabled.
+      # This option, when set to `true`, allows you to avoid explicitly redefining default rules when adding a rule.
+      # Default: false
+      enable-default-rules: true
+
       # Enable validation of comment directives.
       # See https://github.com/mgechev/revive#comment-directives
       directives:
@@ -2390,7 +2400,7 @@ linters:
       confidence: 0.1
       # Revive handles the default rules in a way that can be unexpected:
       # - If there are no explicit rules, the default rules are used.
-      # - If there is at least one explicit rule, the default rules are not used.
+      # - If there is at least one explicit rule, the default rules are not used, unless `enable-default-rules` is `true`.
       # Run `GL_DEBUG=revive golangci-lint run --enable-only=revive` to see default, all available rules, and enabled rules.
       rules:
         # https://github.com/mgechev/revive/blob/HEAD/RULES_DESCRIPTIONS.md#add-constant
@@ -2640,6 +2650,11 @@ linters:
           severity: warning
           disabled: false
           exclude: [""]
+        # https://github.com/mgechev/revive/blob/HEAD/RULES_DESCRIPTIONS.md#forbidden-call-in-wg-go
+        - name: forbidden-call-in-wg-go
+          severity: warning
+          disabled: false
+          exclude: [""]
         # https://github.com/mgechev/revive/blob/HEAD/RULES_DESCRIPTIONS.md#function-length
         - name: function-length
           severity: warning
@@ -2722,6 +2737,11 @@ linters:
           exclude: [""]
           arguments:
             - "preserve-scope"
+        # https://github.com/mgechev/revive/blob/HEAD/RULES_DESCRIPTIONS.md#inefficient-map-lookup
+        - name: inefficient-map-lookup
+          severity: warning
+          disabled: false
+          exclude: [""]
         # https://github.com/mgechev/revive/blob/HEAD/RULES_DESCRIPTIONS.md#line-length-limit
         - name: line-length-limit
           severity: warning
@@ -2840,6 +2860,7 @@ linters:
           disabled: false
           exclude: [""]
           arguments:
+            - "!validate"
             - "json,inline"
             - "bson,outline,gnu"
         # https://github.com/mgechev/revive/blob/HEAD/RULES_DESCRIPTIONS.md#superfluous-else
@@ -2899,6 +2920,11 @@ linters:
           severity: warning
           disabled: false
           exclude: [""]
+        # https://github.com/mgechev/revive/blob/HEAD/RULES_DESCRIPTIONS.md#unnecessary-if
+        - name: unnecessary-if
+          severity: warning
+          disabled: false
+          exclude: [""]
         # https://github.com/mgechev/revive/blob/HEAD/RULES_DESCRIPTIONS.md#unnecessary-stmt
         - name: unnecessary-stmt
           severity: warning
@@ -2974,6 +3000,7 @@ linters:
             - - skip-initialism-name-checks: true
                 upper-case-const: true
                 skip-package-name-checks: true
+                skip-package-name-collision-with-go-std: true
                 extra-bad-package-names:
                   - helpers
                   - models

docs/data/cli_help.json

@@ -8,7 +8,7 @@
   "helpOutput": "Display extra help\n\nUsage:\n  golangci-lint help [flags]\n  golangci-lint help [command]\n\nAvailable Commands:\n  formatters  Display help for formatters.\n  linters     Display help for linters.\n\nGlobal Flags:\n      --color string   Use color when printing; can be 'always', 'auto', or 'never' (default \"auto\")\n  -h, --help           Help for a command\n  -v, --verbose        Verbose output\n\nUse \"golangci-lint help [command] --help\" for more information about a command.\n",
   "migrateOutput": "Migrate configuration file from v1 to v2.\n\nUsage:\n  golangci-lint migrate [flags]\n\nFlags:\n  -c, --config PATH       Read config from file path PATH\n      --no-config         Don't read config file\n      --format string     Output file format.\n                          By default, the format of the input configuration file is used.\n                          It can be 'yml', 'yaml', 'toml', or 'json'.\n      --skip-validation   Skip validation of the configuration file against the JSON Schema for v1.\n\nGlobal Flags:\n      --color string   Use color when printing; can be 'always', 'auto', or 'never' (default \"auto\")\n  -h, --help           Help for a command\n  -v, --verbose        Verbose output\n",
   "configOutput": "Configuration file information and verification.\n\nUsage:\n  golangci-lint config [flags]\n  golangci-lint config [command]\n\nAvailable Commands:\n  path        Print used configuration path.\n  verify      Verify configuration against JSON schema.\n\nFlags:\n  -c, --config PATH   Read config from file path PATH\n      --no-config     Don't read config file\n\nGlobal Flags:\n      --color string   Use color when printing; can be 'always', 'auto', or 'never' (default \"auto\")\n  -h, --help           Help for a command\n  -v, --verbose        Verbose output\n\nUse \"golangci-lint config [command] --help\" for more information about a command.\n",
-  "customOutput": "Build a version of golangci-lint with custom linters.\n\nUsage:\n  golangci-lint custom [flags]\n\nGlobal Flags:\n      --color string   Use color when printing; can be 'always', 'auto', or 'never' (default \"auto\")\n  -h, --help           Help for a command\n  -v, --verbose        Verbose output\n",
+  "customOutput": "Build a version of golangci-lint with custom linters.\n\nUsage:\n  golangci-lint custom [flags]\n\nFlags:\n      --destination string   The directory path used to store the custom binary\n      --name string          The name of the custom binary\n      --version string       The golangci-lint version used to build the custom binary\n\nGlobal Flags:\n      --color string   Use color when printing; can be 'always', 'auto', or 'never' (default \"auto\")\n  -h, --help           Help for a command\n  -v, --verbose        Verbose output\n",
   "cacheOutput": "Cache control and information.\n\nUsage:\n  golangci-lint cache [flags]\n  golangci-lint cache [command]\n\nAvailable Commands:\n  clean       Clean cache\n  status      Show cache status\n\nGlobal Flags:\n      --color string   Use color when printing; can be 'always', 'auto', or 'never' (default \"auto\")\n  -h, --help           Help for a command\n  -v, --verbose        Verbose output\n\nUse \"golangci-lint cache [command] --help\" for more information about a command.\n",
   "versionOutput": "Display the golangci-lint version.\n\nUsage:\n  golangci-lint version [flags]\n\nFlags:\n      --debug   Add build information\n      --json    Display as JSON\n      --short   Display only the version number\n\nGlobal Flags:\n      --color string   Use color when printing; can be 'always', 'auto', or 'never' (default \"auto\")\n  -h, --help           Help for a command\n  -v, --verbose        Verbose output\n",
   "completionOutput": "Generate the autocompletion script for golangci-lint for the specified shell.\nSee each sub-command's help for details on how to use the generated script.\n\nUsage:\n  golangci-lint completion [command]\n\nAvailable Commands:\n  bash        Generate the autocompletion script for bash\n  fish        Generate the autocompletion script for fish\n  powershell  Generate the autocompletion script for powershell\n  zsh         Generate the autocompletion script for zsh\n\nGlobal Flags:\n      --color string   Use color when printing; can be 'always', 'auto', or 'never' (default \"auto\")\n  -h, --help           Help for a command\n  -v, --verbose        Verbose output\n\nUse \"golangci-lint completion [command] --help\" for more information about a command.\n"