Added more detail

realm · Oct 15, 2024 · 4f6079b · 4f6079b
1 parent d9bc578
commit 4f6079b
Showing 1 changed file with 8 additions and 1 deletion.
diff --git a/Source/SwiftLintBuiltInRules/Rules/Style/AttributesRule.swift b/Source/SwiftLintBuiltInRules/Rules/Style/AttributesRule.swift
@@ -19,7 +19,14 @@ struct AttributesRule: OptInRule {
         their own lines before a member declaration has become a conventional Swift style."
 
         "This approach limits declaration length. It allows a member to float below its attribute and supports \
-        flush-left access modifiers, so `internal`, `public`, etc appear in the leftmost column."
+        flush-left access modifiers, so `internal`, `public`, etc appear in the leftmost column. Many developers \
+        mix-and-match styles for short Swift attributes like `@objc`"
+
+        SwiftLint's rule requires attributes to be on their own lines for functions and types, but on the same line \
+        for variables and imports.
+
+        The `attributes_with_arguments_always_on_line_above`, `always_on_same_line`, and `always_on_line_above` \
+        configuration parameters can be used to fine-tune the rules behaviour for particular attributes.
         """,
         kind: .style,
         nonTriggeringExamples: AttributesRuleExamples.nonTriggeringExamples,