rubocop 1.90.0 → 1.91.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 382da6a2b30d9de3a34dfad6d8a2aba1f4c314881d4a7a419d698b58faf07cd4
-  data.tar.gz: 3807b557f0eedb44f81b1a20880649e15b8c76ed31a916756d626a13b391d556
+  metadata.gz: a1d198a5503ecb56c2ee7fc8fc0a22f1bcf5b733cb2d1d22164fc3322da20390
+  data.tar.gz: d698c0ca090ee2dd64879448b9a1e5fc9f51cc2b1816385f60e5c90f490aad99
 SHA512:
-  metadata.gz: 7654d620f9e6504e76855f15335df419416a8353da06cb55c0a15b1fa123b2cabc170792846e8ee5ab1b122003d14038809f524fdf7a07773d51a69b1faca234
-  data.tar.gz: 296dc584530a8191088320cfcfe2fdd38339da0888aac861b510ba219b50a601bd4bd060b831f9733f12553031c20abd91fdcc7ece654d0e716857ef7eb8cee8
+  metadata.gz: f31306b39a0d1daf1606fac0c7e812f04f9d0f50dacb37a22bcd31d3d848e1e66a33c8dc317f1d536c7a96cfb90a6736aacdb6aeacbc5670f9657eab390fe534
+  data.tar.gz: d576dfbeaa9e6eb91c162b8c210054f3b5764a02bf4d8f2bcb8cc01c65441847ed287a040cb28e1e440e74d36ea77bef48c428142f8c34bd5940bc500f9c515f

data/config/default.yml

@@ -60,6 +60,9 @@ AllCops:
     - '.git/**/*'
   # Default formatter will be used if no `-f/--format` option is given.
   DefaultFormatter: progress
+  # The lowest severity that makes a run fail. Offenses below it are still
+  # reported. Can be overridden by the `--fail-level` command line option.
+  FailLevel: refactor
   # Cop names are displayed in offense messages by default. Change behavior
   # by overriding DisplayCopNames, or by giving the `--no-display-cop-names`
   # option.
@@ -116,6 +119,15 @@ AllCops:
   # of extra memory proportional to the bundle's size. Has no effect when
   # `UseProjectIndex` is `false` or when RuboCop does not run inside Bundler.
   ProjectIndexIncludesGems: false
+  # Projects opt in to preview with `Preview: true` here, or with the `--preview`
+  # command line option. In this file the key instead holds the `AllCops`
+  # settings expected to change in the next major release: they apply under
+  # preview and are dropped otherwise, exactly like a cop's `Preview` section.
+  Preview:
+    # Style offenses are reported but stop failing the build; `Lint` and
+    # `Security` offenses still do.
+    FailLevel: warning
+
   # Enables the result cache if `true`. Can be overridden by the `--cache` command
   # line option.
   UseCache: true
@@ -262,6 +274,10 @@ Bundler/OrderedGems:
   Description: >-
                  Gems within groups in the Gemfile should be alphabetically sorted.
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Alphabetical Gemfiles are a preference; grouping gems by purpose is as common.
+  Preview:
+    Enabled: false
   VersionAdded: '0.46'
   VersionChanged: '0.47'
   TreatCommentsAsGroupSeparators: true
@@ -416,6 +432,10 @@ Layout/ArgumentAlignment:
   #     method_call(a,
   #       b)
   EnforcedStyle: with_first_argument
+  # Expected to become the default in the next major release.
+  # Same preference as `ParameterAlignment`.
+  Preview:
+    EnforcedStyle: with_fixed_indentation
   SupportedStyles:
     - with_first_argument
     - with_fixed_indentation
@@ -474,6 +494,7 @@ Layout/BeginEndAlignment:
   SupportedStylesAlignWith:
     - start_of_line
     - begin
+  # A misaligned `end` usually means a structural mistake, so this reports as a lint would.
   Severity: warning
 
 Layout/BlockAlignment:
@@ -503,6 +524,10 @@ Layout/CaseIndentation:
   VersionAdded: '0.49'
   VersionChanged: '1.16'
   EnforcedStyle: case
+  # Expected to become the default in the next major release.
+  # `when` aligned with `end` is the pick of nearly every project that sets this.
+  Preview:
+    EnforcedStyle: end
   SupportedStyles:
     - case
     - end
@@ -581,6 +606,7 @@ Layout/DefEndAlignment:
   SupportedStylesAlignWith:
     - start_of_line
     - def
+  # A misaligned `end` usually means a structural mistake, so this reports as a lint would.
   Severity: warning
 
 Layout/DotPosition:
@@ -610,6 +636,10 @@ Layout/EmptyComment:
 Layout/EmptyLineAfterGuardClause:
   Description: 'Add empty line after guard clause.'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Goes with `GuardClause`; a blank line after a guard is a preference.
+  Preview:
+    Enabled: false
   VersionAdded: '0.56'
   VersionChanged: '0.59'
 
@@ -618,7 +648,7 @@ Layout/EmptyLineAfterMagicComment:
   StyleGuide: '#separate-magic-comments-from-code'
   Enabled: true
   VersionAdded: '0.49'
-  VersionChanged: '1.90'
+  VersionChanged: '1.91'
   # The minimum number of empty lines required after the last magic comment. Set this
   # to `2` when using YARD, which otherwise treats the magic comments as documentation
   # for the first module or class in the file. `Layout/EmptyLines` has to be disabled
@@ -760,10 +790,15 @@ Layout/EndAlignment:
   # The value `start_of_line` means that `end` should be aligned with the start
   # of the line which the matching keyword appears on.
   EnforcedStyleAlignWith: keyword
+  # Expected to become the default in the next major release.
+  # Aligning `end` with the variable is the pick of most projects that set this.
+  Preview:
+    EnforcedStyleAlignWith: variable
   SupportedStylesAlignWith:
     - keyword
     - variable
     - start_of_line
+  # A misaligned `end` usually means a structural mistake, so this reports as a lint would.
   Severity: warning
 
 Layout/EndOfLine:
@@ -839,6 +874,10 @@ Layout/FirstArrayElementIndentation:
   # The value `align_brackets` means that the indentation of the first element
   # shall always be relative to the position of the opening bracket.
   EnforcedStyle: special_inside_parentheses
+  # Expected to become the default in the next major release.
+  # Same preference as `FirstHashElementIndentation`.
+  Preview:
+    EnforcedStyle: consistent
   SupportedStyles:
     - special_inside_parentheses
     - consistent
@@ -873,6 +912,10 @@ Layout/FirstHashElementIndentation:
   # The value `align_braces` means that the indentation of the first key shall
   # always be relative to the position of the opening brace.
   EnforcedStyle: special_inside_parentheses
+  # Expected to become the default in the next major release.
+  # A consistent indent wins over the parentheses-sensitive rule by a wide margin.
+  Preview:
+    EnforcedStyle: consistent
   SupportedStyles:
     - special_inside_parentheses
     - consistent
@@ -1260,6 +1303,10 @@ Layout/MultilineMethodCallIndentation:
   Enabled: true
   VersionAdded: '0.49'
   EnforcedStyle: aligned
+  # Expected to become the default in the next major release.
+  # Indenting continuation lines wins over aligning them by a wide margin.
+  Preview:
+    EnforcedStyle: indented
   SupportedStyles:
     - aligned
     - indented
@@ -1299,6 +1346,10 @@ Layout/MultilineOperationIndentation:
   Enabled: true
   VersionAdded: '0.49'
   EnforcedStyle: aligned
+  # Expected to become the default in the next major release.
+  # Same preference as `MultilineMethodCallIndentation`.
+  Preview:
+    EnforcedStyle: indented
   SupportedStyles:
     - aligned
     - indented
@@ -1328,6 +1379,10 @@ Layout/ParameterAlignment:
   #     def method_foo(a,
   #       b)
   EnforcedStyle: with_first_parameter
+  # Expected to become the default in the next major release.
+  # A fixed indent wins over aligning with the first parameter.
+  Preview:
+    EnforcedStyle: with_fixed_indentation
   SupportedStyles:
     - with_first_parameter
     - with_fixed_indentation
@@ -1746,9 +1801,9 @@ Lint/ConstantResolution:
 
 Lint/CopDirectiveSyntax:
   Description: 'Checks that `# rubocop:` directives are strictly formatted.'
-  Enabled: pending
+  Enabled: true
   VersionAdded: '1.72'
-  VersionChanged: '1.90'
+  VersionChanged: '1.91'
 
 Lint/DataDefineOverride:
   Description: 'Disallow overriding the `Data` built-in methods via `Data.define`.'
@@ -2160,6 +2215,13 @@ Lint/Loop:
   VersionChanged: '1.3'
   Safe: false
 
+Lint/MisplacedMagicComment:
+  Description: 'Checks for magic comments placed where Ruby silently ignores them.'
+  StyleGuide: '#magic-comments-first'
+  Enabled: pending
+  SafeAutoCorrect: false
+  VersionAdded: '1.91'
+
 Lint/MissingCopEnableDirective:
   Description: 'Checks for a `# rubocop:enable` after `# rubocop:disable`.'
   Enabled: true
@@ -2289,7 +2351,7 @@ Lint/OrderedMagicComments:
   Enabled: true
   SafeAutoCorrect: false
   VersionAdded: '0.53'
-  VersionChanged: '1.37'
+  VersionChanged: '1.91'
 
 Lint/OutOfRangeRegexpRef:
   Description: 'Checks for out of range reference for Regexp because it always returns nil.'
@@ -2838,6 +2900,10 @@ Metrics/AbcSize:
     - https://wiki.c2.com/?AbcMetric
     - https://en.wikipedia.org/wiki/ABC_Software_Metric
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Rejected by more than a third of projects; those that keep it split evenly between 20 and 30.
+  Preview:
+    Enabled: false
   VersionAdded: '0.27'
   VersionChanged: '1.5'
   # The ABC size is a calculated magnitude, so this number can be an Integer or
@@ -2850,6 +2916,10 @@ Metrics/AbcSize:
 Metrics/BlockLength:
   Description: 'Avoid long blocks with many lines.'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Rejected by nearly a third of projects; the raised limits range from 30 to 300.
+  Preview:
+    Enabled: false
   VersionAdded: '0.44'
   VersionChanged: '1.5'
   CountComments: false  # count full line comments?
@@ -2867,6 +2937,10 @@ Metrics/BlockNesting:
   Description: 'Avoid excessive block nesting.'
   StyleGuide: '#three-is-the-number-thou-shalt-count'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Rejected by a fifth of projects; almost nobody adjusts the limit instead.
+  Preview:
+    Enabled: false
   VersionAdded: '0.25'
   VersionChanged: '1.65'
   CountBlocks: false
@@ -2876,6 +2950,10 @@ Metrics/BlockNesting:
 Metrics/ClassLength:
   Description: 'Avoid classes longer than 100 lines of code.'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Rejected by a third of projects; those that keep it set the limit three times higher.
+  Preview:
+    Enabled: false
   VersionAdded: '0.25'
   VersionChanged: '0.87'
   CountComments: false  # count full line comments?
@@ -2893,6 +2971,10 @@ Metrics/CollectionLiteralLength:
 Metrics/CyclomaticComplexity:
   Description: 'Checks that the cyclomatic complexity of methods is not higher than the configured maximum.'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Rejected by a third of projects; those that keep it raise the limit to 10 or more.
+  Preview:
+    Enabled: false
   VersionAdded: '0.25'
   VersionChanged: '0.81'
   AllowedMethods: []
@@ -2903,6 +2985,10 @@ Metrics/MethodLength:
   Description: 'Avoid methods longer than 10 lines of code.'
   StyleGuide: '#short-methods'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Rejected outright by a third of projects; the ones that keep it disagree on the limit.
+  Preview:
+    Enabled: false
   VersionAdded: '0.25'
   VersionChanged: '1.5'
   CountComments: false  # count full line comments?
@@ -2914,6 +3000,10 @@ Metrics/MethodLength:
 Metrics/ModuleLength:
   Description: 'Avoid modules longer than 100 lines of code.'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Same story as `ClassLength`.
+  Preview:
+    Enabled: false
   VersionAdded: '0.31'
   VersionChanged: '0.87'
   CountComments: false  # count full line comments?
@@ -2924,6 +3014,10 @@ Metrics/ParameterLists:
   Description: 'Avoid parameter lists longer than three or four parameters.'
   StyleGuide: '#too-many-params'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Rejected by a fifth of projects, more than raise the limit.
+  Preview:
+    Enabled: false
   VersionAdded: '0.25'
   VersionChanged: '1.5'
   Max: 5
@@ -2933,6 +3027,10 @@ Metrics/ParameterLists:
 Metrics/PerceivedComplexity:
   Description: 'Checks that the perceived complexity of methods is not higher than the configured maximum.'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Same story as `CyclomaticComplexity`.
+  Preview:
+    Enabled: false
   VersionAdded: '0.25'
   VersionChanged: '1.88'
   AllowedMethods: []
@@ -3105,6 +3203,10 @@ Naming/HeredocDelimiterNaming:
   Description: 'Use descriptive heredoc delimiters.'
   StyleGuide: '#heredoc-delimiters'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Heredoc delimiter names are rarely worth policing.
+  Preview:
+    Enabled: false
   VersionAdded: '0.50'
   ForbiddenDelimiters:
     - !ruby/regexp '/(^|\s)(EO[A-Z]{1}|END)(\s|$)/i'
@@ -3282,6 +3384,10 @@ Naming/VariableNumber:
   Description: 'Use the configured style when numbering symbols, methods and variables.'
   StyleGuide: '#snake-case-symbols-methods-vars-with-numbers'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # A naming convention few projects want enforced.
+  Preview:
+    Enabled: false
   VersionAdded: '0.50'
   VersionChanged: '1.4'
   EnforcedStyle: normalcase
@@ -3399,6 +3505,10 @@ Style/Alias:
   VersionAdded: '0.9'
   VersionChanged: '0.36'
   EnforcedStyle: prefer_alias
+  # Expected to become the default in the next major release.
+  # `alias_method` is the pick of most projects that set this.
+  Preview:
+    EnforcedStyle: prefer_alias_method
   SupportedStyles:
     - prefer_alias
     - prefer_alias_method
@@ -3545,6 +3655,10 @@ Style/BlockDelimiters:
                 Prefer {...} over do...end for single-line blocks.
   StyleGuide: '#single-line-blocks'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Brace-versus-`do` rules by line count are widely overridden or switched off.
+  Preview:
+    Enabled: false
   VersionAdded: '0.30'
   VersionChanged: '0.35'
   EnforcedStyle: line_count_based
@@ -3703,6 +3817,10 @@ Style/ClassAndModuleChildren:
   # project-wide index is consulted for both operations.
   SafeAutoCorrect: false
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Fights Rails autoloading conventions, and the autocorrect is unsafe.
+  Preview:
+    Enabled: false
   VersionAdded: '0.19'
   VersionChanged: '1.89'
   #
@@ -4019,6 +4137,7 @@ Style/DirectiveScope:
   Enabled: pending
   SafeAutoCorrect: false
   VersionAdded: '1.90'
+  VersionChanged: '1.91'
 
 Style/DisableCopsWithinSourceCodeDirective:
   Description: >-
@@ -4026,9 +4145,18 @@ Style/DisableCopsWithinSourceCodeDirective:
   Enabled: false
   VersionAdded: '0.82'
   VersionChanged: '1.90'
+  # Cop or department names. A directive is exempt only when everything it
+  # disables is listed here.
   AllowedCops: []
+  # Cop or department names. When set, only directives touching these are
+  # flagged.
   DisallowedCops: []
-  AllowTrailingComment: false
+  # Permit a directive that carries a `-- reason` justification, instead of
+  # forbidding directives outright.
+  AllowWithReason: false
+  # Directive forms this cop ignores entirely. One or more of `disable`,
+  # `todo`, `disable-next`, `todo-next`, `push`, `next`.
+  AllowedDirectives: []
 
 Style/DocumentDynamicEvalDefinition:
   Description: >-
@@ -4042,6 +4170,10 @@ Style/DocumentDynamicEvalDefinition:
 Style/Documentation:
   Description: 'Document classes and non-namespace modules.'
   Enabled: true
+  # Turned off by over half of the projects that configure RuboCop at all, so it
+  # is expected to be disabled by default in the next major release.
+  Preview:
+    Enabled: false
   VersionAdded: '0.9'
   VersionChanged: '1.89'
   AllowedConstants: []
@@ -4059,15 +4191,14 @@ Style/DocumentationMethod:
     - 'test/**/*'
   RequireForNonPublicMethods: false
 
-Style/DoubleCopDisableDirective:
-  Description: 'Checks for double rubocop:disable comments on a single line.'
-  Enabled: true
-  VersionAdded: '0.73'
-
 Style/DoubleNegation:
   Description: 'Checks for uses of double negation (!!).'
   StyleGuide: '#no-bang-bang'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # `!!` is the idiomatic boolean coercion.
+  Preview:
+    Enabled: false
   VersionAdded: '0.19'
   VersionChanged: '1.2'
   EnforcedStyle: allowed_in_returns
@@ -4155,6 +4286,10 @@ Style/EmptyMethod:
   VersionAdded: '0.46'
   VersionChanged: '1.61'
   EnforcedStyle: compact
+  # Expected to become the default in the next major release.
+  # Expanded empty methods are the pick of nearly every project that sets this.
+  Preview:
+    EnforcedStyle: expanded
   SupportedStyles:
     - compact
     - expanded
@@ -4329,6 +4464,10 @@ Style/FormatString:
   Description: 'Enforce the use of Kernel#sprintf, Kernel#format or String#%.'
   StyleGuide: '#sprintf'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # A pure preference between `format`, `sprintf` and `%`.
+  Preview:
+    Enabled: false
   VersionAdded: '0.19'
   VersionChanged: '0.49'
   EnforcedStyle: format
@@ -4341,6 +4480,10 @@ Style/FormatStringToken:
   Description: 'Use a consistent style for format string tokens.'
   StyleGuide: '#named-format-tokens'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Most real format strings use `%s`, which is what the cop flags.
+  Preview:
+    Enabled: false
   VersionAdded: '0.49'
   VersionChanged: '1.74'
   EnforcedStyle: annotated
@@ -4369,6 +4512,10 @@ Style/FrozenStringLiteralComment:
                  Add the frozen_string_literal comment to the top of files
                  to help transition to frozen string literals by default.
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Ruby is moving towards frozen string literals by default.
+  Preview:
+    Enabled: false
   VersionAdded: '0.36'
   VersionChanged: '0.79'
   EnforcedStyle: always
@@ -4410,6 +4557,10 @@ Style/GuardClause:
   Description: 'Checks for conditionals that can be replaced with guard clauses.'
   StyleGuide: '#no-nested-conditionals'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Same objection as `IfUnlessModifier`, and among the most inline-suppressed cops.
+  Preview:
+    Enabled: false
   VersionAdded: '0.20'
   VersionChanged: '1.31'
   # `MinBodyLength` defines the number of lines of the a body of an `if` or `unless`
@@ -4566,6 +4717,10 @@ Style/IfUnlessModifier:
                  single-line body.
   StyleGuide: '#if-as-a-modifier'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Forces a shape on control flow that a quarter of configured projects switch off.
+  Preview:
+    Enabled: false
   VersionAdded: '0.9'
   VersionChanged: '0.30'
 
@@ -4717,6 +4872,10 @@ Style/Lambda:
   Description: 'Use the new lambda literal syntax for single-line blocks.'
   StyleGuide: '#lambda-multi-line'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # A pure preference between `->` and `lambda`.
+  Preview:
+    Enabled: false
   VersionAdded: '0.9'
   VersionChanged: '0.40'
   EnforcedStyle: line_count_dependent
@@ -4751,6 +4910,7 @@ Style/MagicCommentFormat:
   Description: 'Use a consistent style for magic comments.'
   Enabled: pending
   VersionAdded: '1.35'
+  VersionChanged: '1.91'
   EnforcedStyle: snake_case
   SupportedStyles:
     # `snake` will enforce the magic comment is written
@@ -4912,6 +5072,10 @@ Style/ModuleFunction:
   Description: 'Checks for usage of `extend self` in modules.'
   StyleGuide: '#module-function'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # `module_function` versus `extend self` is a preference, and the autocorrect is unsafe.
+  Preview:
+    Enabled: false
   VersionAdded: '0.11'
   VersionChanged: '0.65'
   EnforcedStyle: module_function
@@ -5019,6 +5183,10 @@ Style/NegatedIf:
                  (or control flow or).
   StyleGuide: '#unless-for-negatives'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # `if !x` versus `unless x` is a preference, and `unless` is contested on its own.
+  Preview:
+    Enabled: false
   VersionAdded: '0.20'
   VersionChanged: '0.48'
   EnforcedStyle: both
@@ -5113,6 +5281,10 @@ Style/Next:
   Description: 'Use `next` to skip iteration instead of a condition at the end.'
   StyleGuide: '#no-nested-conditionals'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Same objection as `IfUnlessModifier`: it forces a shape on loop bodies.
+  Preview:
+    Enabled: false
   VersionAdded: '0.22'
   VersionChanged: '1.75'
   # With `always` all conditions at the end of an iteration needs to be
@@ -5196,6 +5368,10 @@ Style/NumericLiterals:
                  readability.
   StyleGuide: '#underscores-in-numerics'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # Underscores in long numbers are a preference, and generated tables trip it constantly.
+  Preview:
+    Enabled: false
   VersionAdded: '0.9'
   VersionChanged: '0.48'
   MinDigits: 5
@@ -5214,6 +5390,10 @@ Style/NumericPredicate:
   # of the variables which rubocop doesn't have.
   Safe: false
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # A pure preference between `x > 0` and `x.positive?`.
+  Preview:
+    Enabled: false
   VersionAdded: '0.42'
   VersionChanged: '0.59'
   EnforcedStyle: predicate
@@ -5326,6 +5506,10 @@ Style/ParallelAssignment:
                   matches on both sides of the assignment.
   StyleGuide: '#parallel-assignment'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # `a, b = 1, 2` is often the clearer form.
+  Preview:
+    Enabled: false
   VersionAdded: '0.32'
 
 Style/ParenthesesAroundCondition:
@@ -5377,6 +5561,10 @@ Style/PerlBackrefs:
   Description: 'Avoid Perl-style regex back references.'
   StyleGuide: '#no-perl-regexp-last-matchers'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # `$1` is idiomatic Ruby.
+  Preview:
+    Enabled: false
   VersionAdded: '0.13'
 
 Style/PredicateWithKind:
@@ -5418,6 +5606,10 @@ Style/RaiseArgs:
   Description: 'Checks the arguments passed to raise/fail.'
   StyleGuide: '#exception-class-messages'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # A pure preference between `raise Foo, msg` and `raise Foo.new(msg)`.
+  Preview:
+    Enabled: false
   Safe: false
   VersionAdded: '0.14'
   VersionChanged: '1.61'
@@ -5706,6 +5898,10 @@ Style/RegexpLiteral:
   Description: 'Use / or %r around regular expressions.'
   StyleGuide: '#percent-r'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # A pure preference between `//` and `%r{}`.
+  Preview:
+    Enabled: false
   VersionAdded: '0.9'
   VersionChanged: '0.30'
   EnforcedStyle: slashes
@@ -5738,6 +5934,10 @@ Style/RescueStandardError:
   Enabled: true
   VersionAdded: '0.52'
   EnforcedStyle: explicit
+  # Expected to become the default in the next major release.
+  # A bare `rescue` is the pick of most projects that set this.
+  Preview:
+    EnforcedStyle: implicit
   # implicit: Do not include the error class, `rescue`
   # explicit: Require an error class `rescue StandardError`
   SupportedStyles:
@@ -5861,6 +6061,10 @@ Style/SignalException:
   Description: 'Checks for proper usage of fail and raise.'
   StyleGuide: '#prefer-raise-over-fail'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # `raise` versus `fail` stopped being a meaningful distinction long ago.
+  Preview:
+    Enabled: false
   VersionAdded: '0.11'
   VersionChanged: '0.37'
   EnforcedStyle: only_raise
@@ -5922,6 +6126,10 @@ Style/SpecialGlobalVars:
   Description: 'Avoid Perl-style global variables.'
   StyleGuide: '#no-cryptic-perlisms'
   Enabled: true
+  # Expected to be disabled by default in the next major release.
+  # The long names need `require 'English'`; the short ones are idiomatic.
+  Preview:
+    Enabled: false
   VersionAdded: '0.13'
   VersionChanged: '0.36'
   SafeAutoCorrect: false
@@ -5987,6 +6195,10 @@ Style/StringLiterals:
   VersionAdded: '0.9'
   VersionChanged: '0.36'
   EnforcedStyle: single_quotes
+  # Expected to become the default in the next major release.
+  # Double quotes are what most Ruby is written with; Standard and omakase pick them too.
+  Preview:
+    EnforcedStyle: double_quotes
   SupportedStyles:
     - single_quotes
     - double_quotes
@@ -6001,6 +6213,10 @@ Style/StringLiteralsInInterpolation:
   Enabled: true
   VersionAdded: '0.27'
   EnforcedStyle: single_quotes
+  # Expected to become the default in the next major release.
+  # Follows `Style/StringLiterals`.
+  Preview:
+    EnforcedStyle: double_quotes
   SupportedStyles:
     - single_quotes
     - double_quotes
@@ -6057,6 +6273,10 @@ Style/SymbolArray:
   VersionAdded: '0.9'
   VersionChanged: '0.49'
   EnforcedStyle: percent
+  # Expected to become the default in the next major release.
+  # Bracketed arrays are the pick of nearly every project that sets this; Standard turns the cop off instead.
+  Preview:
+    EnforcedStyle: brackets
   MinSize: 2
   SupportedStyles:
     - percent
@@ -6093,6 +6313,10 @@ Style/TernaryParentheses:
   VersionAdded: '0.42'
   VersionChanged: '0.46'
   EnforcedStyle: require_no_parentheses
+  # Expected to become the default in the next major release.
+  # Parentheses only around complex conditions is the pick of nearly every project that sets this.
+  Preview:
+    EnforcedStyle: require_parentheses_when_complex
   SupportedStyles:
     - require_parentheses
     - require_no_parentheses
@@ -6310,6 +6534,10 @@ Style/WordArray:
   VersionAdded: '0.9'
   VersionChanged: '1.19'
   EnforcedStyle: percent
+  # Expected to become the default in the next major release.
+  # Same preference as `SymbolArray`, and the two are configured together in practice.
+  Preview:
+    EnforcedStyle: brackets
   SupportedStyles:
     # percent style: %w(word1 word2)
     - percent

data/config/obsoletion.yml

@@ -80,6 +80,11 @@ removed:
       `Lint/BinaryOperatorWithIdenticalOperands`. Please use
       `Lint/BinaryOperatorWithIdenticalOperands` instead
   Style/BracesAroundHashParameters: true
+  Style/DoubleCopDisableDirective:
+    severity: warning
+    reason: >
+      it has been superseded by `Lint/CopDirectiveSyntax`. Please use
+      `Lint/CopDirectiveSyntax` instead
   Style/MethodMissingSuper:
     reason: >
       it has been superseded by `Lint/MissingSuper`. Please use
@@ -149,6 +154,10 @@ changed_parameters:
     parameters: IgnoreCopDirectives
     alternative: AllowCopDirectives
     severity: warning
+  - cops: Style/DisableCopsWithinSourceCodeDirective
+    parameters: AllowTrailingComment
+    alternative: AllowWithReason
+    severity: warning
   - cops:
       - Lint/BlockAlignment
       - Layout/BlockAlignment