github
diff --git a/‎swift/ql/.generated.list‎
Lines changed: 2 additions & 2 deletions b/‎swift/ql/.generated.list‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎swift/ql/lib/codeql/swift/elements/MacroRole.qll‎
Lines changed: 9 additions & 0 deletions b/‎swift/ql/lib/codeql/swift/elements/MacroRole.qll‎
Lines changed: 9 additions & 0 deletions
diff --git a/‎swift/ql/lib/codeql/swift/generated/MacroRole.qll‎
Lines changed: 1 addition & 1 deletion b/‎swift/ql/lib/codeql/swift/generated/MacroRole.qll‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎swift/ql/lib/codeql/swift/generated/Raw.qll‎
Lines changed: 1 addition & 1 deletion b/‎swift/ql/lib/codeql/swift/generated/Raw.qll‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎swift/schema.py‎
Lines changed: 1 addition & 1 deletion b/‎swift/schema.py‎
Lines changed: 1 addition & 1 deletion
@@ -4,7 +4,13 @@
 
 private import codeql.swift.generated.MacroRole
 
+/**
+ * The role of a macro, for example #freestanding(declaration) or @attached(member).
+ */
 class MacroRole extends Generated::MacroRole {
+  /**
+   * String representation of the role kind.
+   */
   string getKindName() {
     this.getKind() = 1 and result = "expression"
     or
@@ -25,6 +31,9 @@ class MacroRole extends Generated::MacroRole {
     this.getKind() = 256 and result = "extension"
   }
 
+  /**
+   * String representation of the syntax kind.
+   */
   string getMacroSyntaxName() {
     this.getMacroSyntax() = 0 and result = "#freestanding"
     or
 
@@ -1365,7 +1365,7 @@ class BorrowExpr(IdentityExpr):
 @qltest.test_with('MacroDecl')
 class MacroRole(AstNode):
     """
-    The role of a macro.
+    The role of a macro, for example #freestanding(declaration) or @attached(member).
     """
     kind: int | doc("kind of this macro role (declaration, expression, member, etc.)")
     macro_syntax: int | doc("#freestanding or @attached")