add examples

Author: sneakers-the-rat

linkml_model/model/schema/meta.yaml

@@ -1355,7 +1355,9 @@ slots:
   extra_slots:
     description: |
       How a class instance handles extra data not specified in the class definition.
+      Note that this does *not* define the constraints that are placed on additional slots defined by inheriting classes.
       
+      Possible values:
       - true: allow any additional data
       - false: (default) forbid any additional data
       - anonymous_slot_expression: allow only data matching this anonymous slot expression
@@ -1367,6 +1369,36 @@ slots:
     in_subset:
       - SpecificationSubset
       - BasicSubset
+    examples:
+      - value: true
+        description: Allow all additional data
+      - value: false
+        description: Forbid any additional data
+      - value:
+          range: string
+        description: Allow additional data that are strings
+      - value:
+          range: AClassDefinition
+        description: Allow additional data if they are instances of the class definition "AClassDefinition"
+      - value:
+          any_of:
+            - range: string
+            - range: integer
+        description: allow additional data if they are either strings or integers
+      - value:
+          range: integer
+          multivalued: true
+          maximum_cardinality: 5
+        description: |
+          Allow additional data if they are lists of integers of at most length 5.
+          Note that this does *not* mean that a maximum of 5 extra slots are allowed.
+      - value:
+          range: integer
+          required: true
+        description: |
+          Allow additional data if they are integers. 
+          `required` is meaningless in this context and ignored, since by definition all "extra" slots are optional.
+        
     
 
   # -----------------------------------