Move CRediT roles from Person to usage contexts (Option 1)

Addresses issue where Person class had context-dependent credit_roles
that would cause conflicts when merging datasets by ORCID.

Changes:
- Remove credit_roles from Person class (D4D_Base_import.yaml)
- Add credit_roles to Creator class (D4D_Motivation.yaml)
- Update Person description to clarify dataset-scoped context
- Document that affiliation/email are contextual but acceptable
- Document that credit_roles vary by dataset and belong in usage contexts

Reasoning:
- CRediT roles are inherently dataset-specific (same person, different roles)
- Person should represent stable identity (ORCID) + contact info
- Roles belong to the contribution context, not the person entity
- Affiliation/email remain on Person as they're multivalued and match
  schema.org patterns, representing "current contact for this dataset"

This preserves ability to use ORCID for cross-dataset identification
while allowing role information to vary appropriately by context.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: realmarcin

project/jsonld/data_sheets_schema.jsonld

@@ -2329,7 +2329,7 @@
     },
     {
       "name": "person__affiliation",
-      "description": "The organization(s) to which the person belongs.",
+      "description": "The organization(s) to which the person belongs in the context of this dataset. May vary across datasets; multivalued to support multiple affiliations.",
       "from_schema": "https://w3id.org/bridge2ai/data-sheets-schema/base",
       "mappings": [
         "http://schema.org/affiliation"
@@ -2346,7 +2346,7 @@
     },
     {
       "name": "person__email",
-      "description": "The email address of the person.",
+      "description": "The email address of the person. Represents current/preferred contact information in the context of this dataset.",
       "from_schema": "https://w3id.org/bridge2ai/data-sheets-schema/base",
       "mappings": [
         "http://schema.org/email"
@@ -2362,7 +2362,7 @@
     },
     {
       "name": "person__orcid",
-      "description": "ORCID (Open Researcher and Contributor ID) - a persistent digital identifier for researchers. Format: 0000-0000-0000-0000 (16 digits in groups of 4).",
+      "description": "ORCID (Open Researcher and Contributor ID) - a persistent digital identifier for researchers. Format: 0000-0000-0000-0000 (16 digits in groups of 4). Use this for stable cross-dataset identification.",
       "from_schema": "https://w3id.org/bridge2ai/data-sheets-schema/base",
       "mappings": [
         "http://schema.org/identifier"
@@ -2380,20 +2380,6 @@
       "pattern": "^\\d{4}-\\d{4}-\\d{4}-\\d{3}[0-9X]$",
       "@type": "SlotDefinition"
     },
-    {
-      "name": "person__credit_roles",
-      "description": "Contributor roles using the CRediT (Contributor Roles Taxonomy). Specifies the specific contributions made by this person to the dataset.",
-      "from_schema": "https://w3id.org/bridge2ai/data-sheets-schema/base",
-      "slot_uri": "https://w3id.org/bridge2ai/data-sheets-schema/credit_roles",
-      "alias": "credit_roles",
-      "owner": "Person",
-      "domain_of": [
-        "Person"
-      ],
-      "range": "CRediTRoleEnum",
-      "multivalued": true,
-      "@type": "SlotDefinition"
-    },
     {
       "name": "formatDialect__comment_prefix",
       "from_schema": "https://w3id.org/bridge2ai/data-sheets-schema/base",
@@ -2537,6 +2523,20 @@
       "range": "Organization",
       "@type": "SlotDefinition"
     },
+    {
+      "name": "creator__credit_roles",
+      "description": "Contributor roles using the CRediT (Contributor Roles Taxonomy) for the principal investigator or creator team. Specifies the specific contributions made to this dataset (e.g., Conceptualization, Data Curation, Methodology). Note: roles are specified here rather than on Person directly, since the same person may have different roles across different datasets.",
+      "from_schema": "https://w3id.org/bridge2ai/data-sheets-schema/motivation",
+      "slot_uri": "https://w3id.org/bridge2ai/data-sheets-schema/motivation#credit_roles",
+      "alias": "credit_roles",
+      "owner": "Creator",
+      "domain_of": [
+        "Creator"
+      ],
+      "range": "CRediTRoleEnum",
+      "multivalued": true,
+      "@type": "SlotDefinition"
+    },
     {
       "name": "fundingMechanism__grantor",
       "description": "Name/identifier of the organization providing monetary or resource support.",
@@ -5062,7 +5062,7 @@
     {
       "name": "Person",
       "definition_uri": "https://w3id.org/bridge2ai/data-sheets-schema/Person",
-      "description": "An individual human being.",
+      "description": "An individual human being. This class represents a person in the context of a specific dataset. Attributes like affiliation and email represent the person's current or most relevant contact information for this dataset. For stable cross-dataset identification, use the ORCID field. Note that contributor roles (CRediT) are specified in the usage context (e.g., Creator class) rather than on the Person directly, since roles vary by dataset.",
       "from_schema": "https://w3id.org/bridge2ai/data-sheets-schema/base",
       "mappings": [
         "schema:Person"
@@ -5077,43 +5077,35 @@
         "namedThing__description",
         "person__affiliation",
         "person__email",
-        "person__orcid",
-        "person__credit_roles"
+        "person__orcid"
       ],
       "slot_usage": {},
       "attributes": [
         {
           "name": "affiliation",
-          "description": "The organization(s) to which the person belongs.",
+          "description": "The organization(s) to which the person belongs in the context of this dataset. May vary across datasets; multivalued to support multiple affiliations.",
           "slot_uri": "schema:affiliation",
           "range": "Organization",
           "multivalued": true,
           "@type": "SlotDefinition"
         },
         {
           "name": "email",
-          "description": "The email address of the person.",
+          "description": "The email address of the person. Represents current/preferred contact information in the context of this dataset.",
           "slot_uri": "schema:email",
           "range": "string",
           "@type": "SlotDefinition"
         },
         {
           "name": "orcid",
-          "description": "ORCID (Open Researcher and Contributor ID) - a persistent digital identifier for researchers. Format: 0000-0000-0000-0000 (16 digits in groups of 4).",
+          "description": "ORCID (Open Researcher and Contributor ID) - a persistent digital identifier for researchers. Format: 0000-0000-0000-0000 (16 digits in groups of 4). Use this for stable cross-dataset identification.",
           "exact_mappings": [
             "schema:identifier"
           ],
           "slot_uri": "schema:identifier",
           "range": "string",
           "pattern": "^\\d{4}-\\d{4}-\\d{4}-\\d{3}[0-9X]$",
           "@type": "SlotDefinition"
-        },
-        {
-          "name": "credit_roles",
-          "description": "Contributor roles using the CRediT (Contributor Roles Taxonomy). Specifies the specific contributions made by this person to the dataset.",
-          "range": "CRediTRoleEnum",
-          "multivalued": true,
-          "@type": "SlotDefinition"
         }
       ],
       "class_uri": "http://schema.org/Person",
@@ -5285,7 +5277,8 @@
         "namedThing__description",
         "datasetProperty__used_software",
         "creator__principal_investigator",
-        "creator__affiliation"
+        "creator__affiliation",
+        "creator__credit_roles"
       ],
       "slot_usage": {},
       "attributes": [
@@ -5305,6 +5298,13 @@
           "slot_uri": "schema:affiliation",
           "range": "Organization",
           "@type": "SlotDefinition"
+        },
+        {
+          "name": "credit_roles",
+          "description": "Contributor roles using the CRediT (Contributor Roles Taxonomy) for the principal investigator or creator team. Specifies the specific contributions made to this dataset (e.g., Conceptualization, Data Curation, Methodology). Note: roles are specified here rather than on Person directly, since the same person may have different roles across different datasets.",
+          "range": "CRediTRoleEnum",
+          "multivalued": true,
+          "@type": "SlotDefinition"
         }
       ],
       "class_uri": "https://w3id.org/bridge2ai/data-sheets-schema/motivation#Creator",
@@ -7225,7 +7225,7 @@
   "source_file": "data_sheets_schema.yaml",
   "source_file_date": "2025-11-18T17:40:41",
   "source_file_size": 9614,
-  "generation_date": "2025-11-20T12:15:34",
+  "generation_date": "2025-11-20T12:24:02",
   "@type": "SchemaDefinition",
   "@context": [
     "project/jsonld/data_sheets_schema.context.jsonld",

project/jsonschema/data_sheets_schema.schema.json

@@ -496,6 +496,16 @@
                         "null"
                     ]
                 },
+                "credit_roles": {
+                    "description": "Contributor roles using the CRediT (Contributor Roles Taxonomy) for the principal investigator or creator team. Specifies the specific contributions made to this dataset (e.g., Conceptualization, Data Curation, Methodology). Note: roles are specified here rather than on Person directly, since the same person may have different roles across different datasets.",
+                    "items": {
+                        "$ref": "#/$defs/CRediTRoleEnum"
+                    },
+                    "type": [
+                        "array",
+                        "null"
+                    ]
+                },
                 "description": {
                     "description": "A human-readable description for a thing.",
                     "type": [
@@ -3897,10 +3907,10 @@
         },
         "Person": {
             "additionalProperties": false,
-            "description": "An individual human being.",
+            "description": "An individual human being. This class represents a person in the context of a specific dataset. Attributes like affiliation and email represent the person's current or most relevant contact information for this dataset. For stable cross-dataset identification, use the ORCID field. Note that contributor roles (CRediT) are specified in the usage context (e.g., Creator class) rather than on the Person directly, since roles vary by dataset.",
             "properties": {
                 "affiliation": {
-                    "description": "The organization(s) to which the person belongs.",
+                    "description": "The organization(s) to which the person belongs in the context of this dataset. May vary across datasets; multivalued to support multiple affiliations.",
                     "items": {
                         "type": "string"
                     },
@@ -3909,16 +3919,6 @@
                         "null"
                     ]
                 },
-                "credit_roles": {
-                    "description": "Contributor roles using the CRediT (Contributor Roles Taxonomy). Specifies the specific contributions made by this person to the dataset.",
-                    "items": {
-                        "$ref": "#/$defs/CRediTRoleEnum"
-                    },
-                    "type": [
-                        "array",
-                        "null"
-                    ]
-                },
                 "description": {
                     "description": "A human-readable description for a thing.",
                     "type": [
@@ -3927,7 +3927,7 @@
                     ]
                 },
                 "email": {
-                    "description": "The email address of the person.",
+                    "description": "The email address of the person. Represents current/preferred contact information in the context of this dataset.",
                     "type": [
                         "string",
                         "null"
@@ -3945,7 +3945,7 @@
                     ]
                 },
                 "orcid": {
-                    "description": "ORCID (Open Researcher and Contributor ID) - a persistent digital identifier for researchers. Format: 0000-0000-0000-0000 (16 digits in groups of 4).",
+                    "description": "ORCID (Open Researcher and Contributor ID) - a persistent digital identifier for researchers. Format: 0000-0000-0000-0000 (16 digits in groups of 4). Use this for stable cross-dataset identification.",
                     "pattern": "^\\d{4}-\\d{4}-\\d{4}-\\d{3}[0-9X]$",
                     "type": [
                         "string",