diff --git a/linkml_model/model/schema/meta.yaml b/linkml_model/model/schema/meta.yaml
index b09fff8b..2b36ea02 100644
--- a/linkml_model/model/schema/meta.yaml
+++ b/linkml_model/model/schema/meta.yaml
@@ -1231,11 +1231,11 @@ slots:
     multivalued: true
     range: slot_definition
     inlined: true
-    description: Inline definition of slots
+    description: Inline definition of class-scoped slots
     comments:
       - >-
-        attributes are an alternative way of defining new slots.  An attribute adds a slot to the global space in the
-        form <class_name>__<slot_name> (lower case, double underscores).  Attributes can be specialized via slot_usage.
+        Attributes are an alternative way of defining class-specific slots.
+        They are equivalent to slots that are only available within the scope of class and its descendants.
     in_subset:
       - SpecificationSubset
       - MinimalSubset