Improve documentation of AttributeSyntax.arguments

Author: ahoppen

CodeGeneration/Sources/SyntaxSupport/AttributeNodes.swift

@@ -153,7 +153,12 @@ public let ATTRIBUTE_NODES: [Node] = [
             kind: .node(kind: .documentationAttributeArgumentList)
           ),
         ]),
-        documentation: "The arguments of the attribute. In case the attribute takes multiple arguments, they are gather in the appropriate takes first.",
+        documentation: """
+          The arguments of the attribute.
+
+          In case of user-defined attributes, such as macros, property wrappers or result builders,
+          this is always either an `argumentList` of type ``LabeledExprListSyntax`` or `nil`.
+          """,
         isOptional: true
       ),
       Child(

CodeGeneration/Sources/SyntaxSupport/DeclNodes.swift

@@ -2326,7 +2326,7 @@ public let DECL_NODES: [Node] = [
     documentation: """
       Declaration of one or more variables
 
-      The core of a variable declaration consists of a binding specifier (`let` or `var),
+      The core of a variable declaration consists of a binding specifier (`let` or `var`),
       followed by any number of pattern bindings, which define the variables.
       """,
     traits: [
@@ -2364,7 +2364,7 @@ public let DECL_NODES: [Node] = [
           initializers and accessors.
 
           A variable declaration can contain multiple pattern bindings, because it’s possible
-          to define multiple variables after a single `let` keyword as follows.
+          to define multiple variables after a single `let` keyword, for example
 
           ```swift
           let x: Int = 1, y: Int = 2

Sources/SwiftSyntax/generated/syntaxNodes/SyntaxDeclNodes.swift

@@ -6971,7 +6971,7 @@ public struct TypeAliasDeclSyntax: DeclSyntaxProtocol, SyntaxHashable {
 
 /// Declaration of one or more variables
 /// 
-/// The core of a variable declaration consists of a binding specifier (`let` or `var),
+/// The core of a variable declaration consists of a binding specifier (`let` or `var`),
 /// followed by any number of pattern bindings, which define the variables.
 ///
 /// ### Children
@@ -7174,7 +7174,7 @@ public struct VariableDeclSyntax: DeclSyntaxProtocol, SyntaxHashable {
   /// initializers and accessors.
   /// 
   /// A variable declaration can contain multiple pattern bindings, because it’s possible
-  /// to define multiple variables after a single `let` keyword as follows.
+  /// to define multiple variables after a single `let` keyword, for example
   /// 
   /// ```swift
   /// let x: Int = 1, y: Int = 2

Sources/SwiftSyntax/generated/syntaxNodes/SyntaxNodes.swift

@@ -913,7 +913,7 @@ public struct AttributeSyntax: SyntaxProtocol, SyntaxHashable {
   ///   - atSign: The `@` sign.
   ///   - attributeName: The name of the attribute.
   ///   - leftParen: If the attribute takes arguments, the opening parenthesis.
-  ///   - arguments: The arguments of the attribute. In case the attribute takes multiple arguments, they are gather in the appropriate takes first.
+  ///   - arguments: The arguments of the attribute.
   ///   - rightParen: If the attribute takes arguments, the closing parenthesis.
   ///   - trailingTrivia: Trivia to be appended to the trailing trivia of the node’s last token. If the node is empty, there is no token to attach the trivia to and the parameter is ignored.
   public init(
@@ -1039,7 +1039,10 @@ public struct AttributeSyntax: SyntaxProtocol, SyntaxHashable {
     }
   }
 
-  /// The arguments of the attribute. In case the attribute takes multiple arguments, they are gather in the appropriate takes first.
+  /// The arguments of the attribute.
+  /// 
+  /// In case of user-defined attributes, such as macros, property wrappers or result builders,
+  /// this is always either an `argumentList` of type ``LabeledExprListSyntax`` or `nil`.
   public var arguments: Arguments? {
     get {
       return data.child(at: 7, parent: Syntax(self)).map(Arguments.init)