Enhance LinkML class definitions for GLAM ontology

- Updated AppraisalPolicy.yaml with improved descriptions, multilingual support, structured aliases, and refined mappings.
- Revised AppreciationEvent.yaml to include detailed descriptions, alt_descriptions in multiple languages, and structured data for engagement metrics.
- Enhanced ApprovalTimeType.yaml and ApprovalTimeTypes.yaml with comprehensive descriptions, multilingual support, and structured aliases for approval durations.
- Improved Approver.yaml by refining the description, adding multilingual support, and clarifying mappings for approval agents.
- Created check_class_prompt-20260214.md to outline goals and rules for improving class file quality, including description standards, multilingual support, and mapping verification.

docs/prompt/check_class_prompt-20260214.md

@@ -0,0 +1,119 @@
+---
+Goal
+Improve the quality of LinkML class files in a GLAM (Galleries, Libraries, Archives, Museums) ontology project by:
+1. Writing proper dictionary-style descriptions without repeating class names
+2. Adding multilingual support (alt_descriptions and structured_aliases in 7 languages: nl, de, fr, es, ar, id, zh)
+3. Structuring data properly using LinkML annotations (examples:, keywords:, comments:)
+4. Ensuring all ontology mappings use the correct category (exact_mappings vs broad_mappings vs close_mappings vs narrow_mappings vs related_mappings)
+5. Verifying all Wikidata mappings are semantically correct
+6. Creating and updating rules in .opencode/rules/
+Instructions
+Key Rules Created/Updated
+1. class-description-quality-rule.md: 
+   - No repetition of class name in descriptions
+   - MIGRATE structured data before removing from descriptions
+   - Use folded block scalar (>-)
+   - Use examples: annotation properly
+2. linkml-yaml-best-practices-rule.md:
+   - equals_expression anti-pattern → use equals_string or any_of
+   - Declare all prefixes
+   - Import referenced classes
+   - Quote regex patterns and annotation values
+3. class-multilingual-support-rule.md:
+   - Required languages: nl, de, fr, es, ar, id, zh
+   - Structure for alt_descriptions and structured_aliases
+4. mapping-specificity-hypernym-rule.md (updated):
+   - Classes that are NEVER exact mappings: schema:Action, schema:Organization, schema:Thing, schema:PropertyValue, schema:Permit, prov:Activity, skos:Concept, crm:E55_Type, crm:E42_Identifier, dcat:DataService
+   - Type compatibility: class→class, property→property
+   - Decision tree for mapping type
+5. wikidata-mapping-verification-rule.md:
+   - Use wikidata-authenticated_execute_sparql to verify QIDs
+   - SPARQL templates for batch verification
+6. wikidata-mapping-discovery-rule.md (updated):
+   - ALWAYS verify BOTH label AND description before adding
+   - Check type compatibility (organization→organization, NOT organization→building)
+   - Examples of WRONG mappings found: Q22075301 (textile artwork) was mapped to FacultyPaperCollection!
+   - "Better no mapping than wrong mapping" principle
+Discoveries
+1. Wrong Wikidata mappings found and removed:
+   - Q22075301 (textile artwork) → was mapped to FacultyPaperCollection ❌
+   - Q1643722 (building in Vienna) → was mapped to UniversityAdministrativeFonds ❌
+   - Q185583 (candy) → was mapped to AcademicStudentRecordSeries ❌
+2. Wrong mapping categories corrected:
+   - schema:Action was exact_mappings → should be broad_mappings
+   - crm:E55_Type was exact_mappings → should be broad_mappings
+   - prov:Activity was exact_mappings → should be broad_mappings
+   - schema:Organization was exact_mappings → should be broad_mappings
+   - crm:E42_Identifier was exact_mappings → should be broad_mappings
+3. Verified correct Wikidata mappings:
+   - Q27032435 (academic archive) → AcademicArchive (exact) ✓
+   - Q38723 (higher education institution) → AcademicInstitution (exact) ✓
+   - Q9388534 (archival collection) → CampusDocumentationCollection (related) ✓
+4. Conceptual model clarification:
+   - AcademicArchive = the institution (organizational entity)
+   - AcademicArchiveRecordSetType = the classification of record sets
+Accomplished
+Fully Processed Class Files (25 files)
+All with: dictionary-style descriptions, 7-language alt_descriptions, 7-language structured_aliases, proper examples, keywords, correct mapping categories, verified Wikidata mappings
+| File | Key Mappings |
+|------|--------------|
+| AcademicArchive.yaml | wd:Q27032435 (exact), wd:Q166118 (broad) |
+| AcademicArchiveRecordSetType.yaml | wd:Q27032435 (close), rico:RecordSetType (broad) |
+| AcademicArchiveRecordSetTypes.yaml | 4 subclasses, rico-rst mappings |
+| AcademicInstitution.yaml | wd:Q38723 (exact), wd:Q4671277 (close) |
+| AcademicProgram.yaml | schema:EducationalOccupationalProgram (exact), wd:Q600134 (close) |
+| Access.yaml | dcterms:RightsStatement (exact) |
+| AccessApplication.yaml | schema:Action (broad) |
+| AccessControl.yaml | schema:DigitalDocumentPermission (close) |
+| AccessibilityFeature.yaml | schema:LocationFeatureSpecification (close) |
+| AccessInterface.yaml | dcat:DataService (broad) |
+| AccessionEvent.yaml | crm:E63_Beginning_of_Existence (broad) |
+| AccessionNumber.yaml | crm:E42_Identifier (broad), rico:Identifier (broad) |
+| AccessLevel.yaml | skos:Concept (broad) |
+| AccessTriggerEvent.yaml | prov:Activity (broad) |
+| AccountIdentifier.yaml | schema:PropertyValue (broad) |
+| AccountStatus.yaml | skos:Concept (broad) |
+| Accreditation.yaml | schema:Permit (broad) |
+| AccreditationBody.yaml | schema:Organization (broad) |
+| AccreditationEvent.yaml | prov:Activity (broad) |
+| Accumulation.yaml | rico:AccumulationRelation (exact) |
+| AccuracyLevel.yaml | skos:Concept (broad) |
+| Acquisition.yaml | crm:E8_Acquisition (exact) |
+| AcquisitionEvent.yaml | crm:E10_Transfer_of_Custody (exact) |
+| AcquisitionMethod.yaml | crm:E55_Type (broad) |
+Rules Created (6 new/updated)
+- class-description-quality-rule.md
+- class-multilingual-support-rule.md
+- linkml-yaml-best-practices-rule.md
+- mapping-specificity-hypernym-rule.md (updated)
+- wikidata-mapping-verification-rule.md
+- wikidata-mapping-discovery-rule.md (updated)
+Remaining Work
+- Continue processing remaining class files in /Users/kempersc/apps/glam/schemas/20251121/linkml/modules/classes/
+- Fix LSP errors in CollectionType.yaml, UniversityArchiveRecordSetTypes.yaml, AccessPolicy.yaml (duplicate keys)
+Relevant files / directories
+Directories
+- Classes: /Users/kempersc/apps/glam/schemas/20251121/linkml/modules/classes/ (~1,378 YAML files)
+- Rules: /Users/kempersc/apps/glam/.opencode/rules/ (47 rule files)
+- Ontology data: /Users/kempersc/apps/glam/data/ontology/ (RDF/RDFS/OWL files)
+Key Processed Class Files
+- AcademicArchive.yaml
+- AcademicArchiveRecordSetType.yaml
+- AcademicArchiveRecordSetTypes.yaml (contains 4 subclasses)
+- AcademicInstitution.yaml
+- AcademicProgram.yaml
+- Access.yaml through AcquisitionMethod.yaml (20 Access/Accr/Acq files)
+Rules Created/Updated This Session
+- class-description-quality-rule.md
+- class-multilingual-support-rule.md
+- linkml-yaml-best-practices-rule.md
+- mapping-specificity-hypernym-rule.md
+- wikidata-mapping-verification-rule.md
+- wikidata-mapping-discovery-rule.md
+Files with LSP Errors (need fixing)
+- CollectionType.yaml (line 81 - duplicate key)
+- UniversityArchiveRecordSetTypes.yaml (lines 51, 86, 119 - duplicate keys)
+- AccessPolicy.yaml (lines 129, 133, 184 - duplicate require: keys)
+
+Never remove structured data represented as string: properly structuralise it using the LinkML conventions and syntax instead. We do need to keep structured data out of the description, but try to preserve it as structured LinkML data. See https://linkml.io/linkml/
+REMEMBER THAT MAPPING HALLUCINATED CLASSES OR PREDICATES OR QID IS STRICTLY PROHIBITED! Always double check the Link mappings and the mappings categories (https://linkml.io/linkml-model/latest/docs/mappings/) through studying @data/ontology/ and Wikidata (using the Wikidata MCP) carefully! Continue with:

frontend/public/schemas/20251121/linkml/manifest.json

@@ -1,5 +1,5 @@
 {
-  "generated": "2026-02-14T21:37:12.868Z",
+  "generated": "2026-02-14T22:09:30.699Z",
   "schemaRoot": "/schemas/20251121/linkml",
   "totalFiles": 2369,
   "categoryCounts": {

schemas/20251121/linkml/manifest.json

@@ -1,5 +1,5 @@
 {
-  "generated": "2026-02-14T22:09:30.699Z",
+  "generated": "2026-02-14T22:59:33.420Z",
   "schemaRoot": "/schemas/20251121/linkml",
   "totalFiles": 2369,
   "categoryCounts": {

schemas/20251121/linkml/modules/classes/APIEndpoint.yaml

@@ -1,25 +1,95 @@
 id: https://nde.nl/ontology/hc/class/APIEndpoint
 name: APIEndpoint
-title: APIEndpoint
+title: API Endpoint Class
-description: An API endpoint.
 prefixes:
   linkml: https://w3id.org/linkml/
+  hc: https://nde.nl/ontology/hc/
   schema: http://schema.org/
   skos: http://www.w3.org/2004/02/skos/core#
-  rico: https://www.ica.org/standards/RiC/ontology#
+  dcat: http://www.w3.org/ns/dcat#
-  wd: http://www.wikidata.org/entity/
+  hydra: http://www.w3.org/ns/hydra/core#
-classes:
+default_prefix: hc
-  APIEndpoint:
-    class_uri: schema:EntryPoint
-    description: An API endpoint.
-    slots:
-    - has_url
-    - has_description
-    annotations:
-      specificity_score: 0.1
-      specificity_rationale: Generic utility class/slot created during migration
-      custodian_types: "['*']"
 imports:
   - linkml:types
   - ../slots/has_description
   - ../slots/has_url
+classes:
+  APIEndpoint:
+    class_uri: schema:EntryPoint
+    description: >-
+      Uniform Resource Locator that provides programmatic access to a service
+      or data resource through a defined interface specification.
+    alt_descriptions:
+      nl: >-
+        Uniform Resource Locator die programmatische toegang biedt tot een service
+        of gegevensbron via een gedefinieerde interfacespecificatie.
+      de: >-
+        Uniform Resource Locator, der programmatischen Zugriff auf einen Dienst
+        oder eine Datenressource uber eine definierte Schnittstellenspezifikation bietet.
+      fr: >-
+        Localisateur uniforme de ressources fournissant un acces programmatique
+        a un service ou a une ressource de donnees via une specification d'interface definie.
+      es: >-
+        Localizador uniforme de recursos que proporciona acceso programatico a un
+        servicio o recurso de datos a traves de una especificacion de interfaz definida.
+      ar: >-
+        محدد موقع الموارد المنتظم الذي يوفر وصولاً برمجياً إلى خدمة أو مورد بيانات
+        من خلال مواصفات واجهة محددة.
+      id: >-
+        Uniform Resource Locator yang menyediakan akses terprogram ke layanan atau
+        sumber daya data melalui spesifikasi antarmuka yang ditentukan.
+      zh: >-
+        通过定义的接口规范提供服务或数据资源的编程访问的统一资源定位符。
+    structured_aliases:
+    - literal_form: API-eindpunt
+      in_language: nl
+    - literal_form: API-Endpunkt
+      in_language: de
+    - literal_form: point de terminaison API
+      in_language: fr
+    - literal_form: punto final API
+      in_language: es
+    - literal_form: نقطة نهاية API
+      in_language: ar
+    - literal_form: titik akhir API
+      in_language: id
+    - literal_form: API端点
+      in_language: zh
+    exact_mappings:
+    - schema:EntryPoint
+    close_mappings:
+    - hydra:EntryPoint
+    - dcat:DataService
+    broad_mappings:
+    - skos:Concept
+    slots:
+    - has_url
+    - has_description
+    comments:
+    - Represents a callable URL for an API operation
+    - Part of schema.org for describing web services
+    - Use with APIVersion for versioned endpoints
+    see_also:
+    - https://schema.org/EntryPoint
+    - APIVersion
+    - APIRequest
+    examples:
+    - value:
+        has_url: "https://api.example.org/v2/collections"
+        has_description: "Collections listing endpoint"
+      description: REST API endpoint for collections
+    - value:
+        has_url: "https://api.example.org/v2/search"
+        has_description: "Search endpoint with query parameters"
+      description: Search API endpoint
+    keywords:
+    - API
+    - endpoint
+    - URL
+    - web service
+    - REST
+    - programmatic access
+    annotations:
+      specificity_score: "0.3"
+      specificity_rationale: Specific to API/web service endpoints
+      custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/APIRequest.yaml

@@ -1,14 +1,14 @@
 id: https://nde.nl/ontology/hc/class/APIRequest
 name: APIRequest
-title: APIRequest
+title: API Request Class
-description: An API request event.
 prefixes:
-  rov: http://www.w3.org/ns/regorg#
   linkml: https://w3id.org/linkml/
+  hc: https://nde.nl/ontology/hc/
   schema: http://schema.org/
   skos: http://www.w3.org/2004/02/skos/core#
-  rico: https://www.ica.org/standards/RiC/ontology#
+  prov: http://www.w3.org/ns/prov#
-  wd: http://www.wikidata.org/entity/
+  dcat: http://www.w3.org/ns/dcat#
+default_prefix: hc
 imports:
   - linkml:types
   - ../slots/has_endpoint
@@ -16,15 +16,89 @@ imports:
   - ../slots/has_version
 classes:
   APIRequest:
-    class_uri: prov:Activity
+    class_uri: hc:APIRequest
+    description: >-
+      Single invocation of an API endpoint, capturing the request context,
+      provenance, and version information for audit and debugging purposes.
+    alt_descriptions:
+      nl: >-
+        Enkele aanroeping van een API-eindpunt, waarbij de verzoekcontext,
+        herkomst en versie-informatie worden vastgelegd voor controle en debugging.
+      de: >-
+        Einzelner Aufruf eines API-Endpunkts, der den Anfragekontext,
+        die Provenienz und Versionsinformationen fur Audit und Debugging erfasst.
+      fr: >-
+        Invocation unique d'un point de terminaison API, capturant le contexte
+        de la requete, la provenance et les informations de version pour l'audit
+        et le debogage.
+      es: >-
+        Invocacion unica de un punto final API, capturando el contexto de la solicitud,
+        la procedencia y la informacion de version para auditoria y depuracion.
+      ar: >-
+        استدعاء واحد لنقطة نهاية API، يلتقط سياق الطلب والمصدر ومعلومات الإصدار
+        لأغراض التدقيق وتصحيح الأخطاء.
+      id: >-
+        Pemanggilan tunggal titik akhir API, menangkap konteks permintaan,
+        provenans, dan informasi versi untuk audit dan debugging.
+      zh: >-
+        对API端点的单次调用，捕获请求上下文、来源和版本信息用于审计和调试。
+    structured_aliases:
+    - literal_form: API-verzoek
+      in_language: nl
+    - literal_form: API-Anfrage
+      in_language: de
+    - literal_form: requete API
+      in_language: fr
+    - literal_form: solicitud API
+      in_language: es
+    - literal_form: طلب API
+      in_language: ar
+    - literal_form: permintaan API
+      in_language: id
+    - literal_form: API请求
+      in_language: zh
+    broad_mappings:
+    - prov:Activity
+    - schema:Action
     close_mappings:
-      - schema:Action
+    - dcat:DataService
-    description: An API request event.
     slots:
     - has_provenance
     - has_endpoint
     - has_version
+    slot_usage:
+      has_endpoint:
+        range: APIEndpoint
+        required: true
+      has_provenance:
+        range: Provenance
+        required: false
+      has_version:
+        range: APIVersion
+        required: false
+    comments:
+    - Captures individual API call events for logging and analysis
+    - Useful for rate limiting, audit trails, and usage analytics
+    - Links to endpoint definition and API version
+    see_also:
+    - APIEndpoint
+    - APIVersion
+    examples:
+    - value:
+        has_endpoint: "https://api.example.org/v2/search"
+        has_provenance:
+          created_by: "https://example.org/users/app123"
+          created_at: "2025-01-14T10:00:00Z"
+        has_version: "v2.1.0"
+      description: Logged search API request with provenance
+    keywords:
+    - API request
+    - API call
+    - invocation
+    - audit
+    - logging
+    - provenance
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.4"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Specific to API request event tracking
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/APIVersion.yaml

@@ -1,25 +1,107 @@
 id: https://nde.nl/ontology/hc/class/APIVersion
 name: APIVersion
-title: APIVersion
+title: API Version Class
-description: Version of an API.
 prefixes:
   linkml: https://w3id.org/linkml/
+  hc: https://nde.nl/ontology/hc/
   schema: http://schema.org/
   skos: http://www.w3.org/2004/02/skos/core#
-  rico: https://www.ica.org/standards/RiC/ontology#
+  dcat: http://www.w3.org/ns/dcat#
-  wd: http://www.wikidata.org/entity/
+  dcterms: http://purl.org/dc/terms/
+default_prefix: hc
 imports:
   - linkml:types
   - ../slots/identified_by
   - ../slots/has_label
 classes:
   APIVersion:
-    class_uri: schema:SoftwareApplication
+    class_uri: hc:APIVersion
-    description: Version of an API.
+    description: >-
+      Specific release or iteration of an Application Programming Interface,
+      identified by version number and potentially associated with changelogs
+      and deprecation schedules.
+    alt_descriptions:
+      nl: >-
+        Specifieke release of iteratie van een Application Programming Interface,
+        geidentificeerd door versienummer en mogelijk gekoppeld aan changelogs
+        en deprecation-schema's.
+      de: >-
+        Spezifische Veroffentlichung oder Iteration einer Programmierschnittstelle,
+        identifiziert durch Versionsnummer und moglicherweise verknupft mit
+        Anderungsprotokollen und Deprecation-Zeitplanen.
+      fr: >-
+        Version specifique ou iteration d'une interface de programmation d'application,
+        identifiee par numero de version et potentiellement associee aux journaux
+        des modifications et aux calendriers d'obsolescence.
+      es: >-
+        Version especifica o iteracion de una interfaz de programacion de aplicaciones,
+        identificada por numero de version y potencialmente asociada con registros
+        de cambios y calendarios de obsolescencia.
+      ar: >-
+        إصدار محدد أو تكرار لواجهة برمجة التطبيقات، محدد برقم الإصدار وربما
+        مرتبط بسجلات التغيير وجداول الإهمال.
+      id: >-
+        Rilis atau iterasi spesifik dari Antarmuka Pemrograman Aplikasi, diidentifikasi
+        oleh nomor versi dan berpotensi terkait dengan log perubahan dan jadwal penghentian.
+      zh: >-
+        应用程序编程接口的特定版本或迭代，由版本号标识，可能与变更日志和弃用计划相关联。
+    structured_aliases:
+    - literal_form: API-versie
+      in_language: nl
+    - literal_form: API-Version
+      in_language: de
+    - literal_form: version d'API
+      in_language: fr
+    - literal_form: version de API
+      in_language: es
+    - literal_form: إصدار API
+      in_language: ar
+    - literal_form: versi API
+      in_language: id
+    - literal_form: API版本
+      in_language: zh
+    close_mappings:
+    - schema:SoftwareVersion
+    - dcterms:hasVersion
+    broad_mappings:
+    - skos:Concept
     slots:
     - has_label
     - identified_by
+    slot_usage:
+      has_label:
+        pattern: "^v?[0-9]+\\.[0-9]+(\\.[0-9]+)?(-[a-zA-Z0-9]+)?$"
+        examples:
+        - value: "v2.1.0"
+        - value: "1.0.0-beta"
+        - value: "2.0"
+      identified_by:
+        range: string
+        required: true
+    comments:
+    - Follows semantic versioning convention (MAJOR.MINOR.PATCH)
+    - Used to track API compatibility and deprecation
+    - Links to endpoint definitions for versioned access
+    see_also:
+    - APIEndpoint
+    - https://semver.org/
+    examples:
+    - value:
+        has_label: "v2.1.0"
+        identified_by: "v2.1.0"
+      description: Semantic version 2.1.0 of an API
+    - value:
+        has_label: "v3.0.0-beta"
+        identified_by: "v3.0.0-beta"
+      description: Beta release of version 3.0.0
+    keywords:
+    - API version
+    - semantic versioning
+    - release
+    - changelog
+    - deprecation
+    - compatibility
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.4"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Specific to API versioning
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/Activity.yaml

@@ -27,16 +27,144 @@ imports:
 classes:
   Activity:
     class_uri: prov:Activity
-    description: "Base class for activities performed by heritage custodians.\n\n**DEFINITION**:\n\nAn Activity represents a discrete or ongoing action undertaken by a heritage\ncustodian. This is the base class for all activity instances in the ontology.\n\n**ONTOLOGICAL ALIGNMENT**:\n\n| Ontology | Class | Use Case |\n|----------|-------|----------|\n| PROV-O | prov:Activity | Primary - provenance tracking |\n| CIDOC-CRM | crm:E7_Activity | Cultural heritage domain |\n| RiC-O | rico:Activity | Archival activities |\n| Schema.org | schema:Action | Web semantics |\n\n**KEY RELATIONSHIPS**:\n\n```\nActivity\n    \u2502\n    \u251C\u2500\u2500 has_activity_type \u2192 ActivityType (classification)\n    \u2502       \u2514\u2500\u2500 CurationActivityType, ConservationActivityType, etc.\n    \u2502\n    \u251C\u2500\u2500 has_timespan \u2192 TimeSpan (temporal extent)\n    \u2502       \u2514\u2500\u2500 start_date, end_date, fuzzy bounds\n    \u2502\n    \u251C\u2500\u2500 succeeded_by\
+    description: >-
-      \ \u2192 Activity (succession)\n    \u2502\n    \u2514\u2500\u2500 preceding_activity \u2192 Activity (inverse succession)\n```\n\n**SPECIALIZATION**:\n\nThis base class is extended by domain-specific activity classes:\n- CurationActivity - Collection management (existing, to be refactored)\n- ConservationActivity - Preservation work\n- ExhibitionActivity - Exhibition planning and execution\n- DigitizationActivity - Digital transformation projects\n\n**PROVENANCE (PROV-O)**:\n\nActivities generate provenance information:\n- `prov:Activity` - The activity itself\n- `prov:wasAssociatedWith` - Responsible agents\n- `prov:used` - Entities processed\n- `prov:generated` - Entities created\n- `prov:atTime` - Temporal extent\n"
+      Discrete or ongoing action undertaken by a heritage custodian.
-    exact_mappings:
+      
-    - prov:Activity
+      Base class for all activity instances in the ontology, representing 
+      provenance-tracked operations such as collection inventory, digitization 
+      projects, conservation treatments, and cataloging workflows.
+    alt_descriptions:
+      nl:
+        text: >-
+          Discrete of doorlopende actie uitgevoerd door een erfgoedbeheerder.
+          
+          Basisklasse voor alle activiteitsinstanties in de ontologie, 
+          voor provenance-tracking van operaties zoals collectie-inventarisatie, 
+          digitaliseringsprojecten, conserveringsbehandelingen en catalogiseringsworkflows.
+      de:
+        text: >-
+          Diskrete oder laufende Handlung, die von einem Kulturgüterverwalter durchgeführt wird.
+          
+          Basisklasse für alle Aktivitätsinstanzen in der Ontologie zur 
+          Provenienzverfolgung von Vorgängen wie Bestandsinventur, Digitalisierungsprojekten, 
+          Konservierungsbehandlungen und Katalogisierungsworkflows.
+      fr:
+        text: >-
+          Action discrète ou continue entreprise par un dépositaire du patrimoine.
+          
+          Classe de base pour toutes les instances d'activités dans l'ontologie, 
+          assurant le suivi de la provenance des opérations telles que l'inventaire des collections, 
+          les projets de numérisation, les traitements de conservation et les flux de catalogage.
+      es:
+        text: >-
+          Acción discreta o continua realizada por un custodio del patrimonio.
+          
+          Clase base para todas las instancias de actividades en la ontología, 
+          para el seguimiento de procedencia de operaciones como inventarios de colecciones, 
+          proyectos de digitalización, tratamientos de conservación y flujos de catalogación.
+      ar:
+        text: >-
+          إجراء منفصل أو مستمر يقوم به أمين التراث.
+          
+          الفئة الأساسية لجميع حالات النشاط في الأنطولوجيا، لتتبع مصدر العمليات 
+          مثل جرد المجموعات ومشاريع الرقمنة ومعالجات الحفظ وسير عمل الفهرسة.
+      id:
+        text: >-
+          Tindakan diskrit atau berkelanjutan yang dilakukan oleh pengelola warisan.
+          
+          Kelas dasar untuk semua instance aktivitas dalam ontologi, 
+          untuk pelacakan provenans operasi seperti inventarisasi koleksi, 
+          proyek digitalisasi, perlakuan konservasi, dan alur kerja katalogisasi.
+      zh:
+        text: >-
+          由遗产保管人执行的离散或持续行动。
+          
+          本体中所有活动实例的基类，用于追踪收藏清点、数字化项目、
+          保护处理和编目工作流等操作的来源。
+    examples:
+    - value:
+        identified_by:
+          identifier_value: https://nde.nl/ontology/hc/activity/rijksmuseum-inventory-2025-001
+        has_label: 2025 Annual Collection Inventory - Dutch Masters
+        has_description: "Annual physical inventory of the Dutch Masters collection (Gallery of Honour and adjacent galleries). Spot-check methodology with 20% sample verification against CMS records."
+        temporal_extent:
+          begin_of_the_begin: '2025-01-15'
+          end_of_the_end: '2025-03-31'
+        has_status: IN_PROGRESS
+      description: Annual collection inventory activity at a museum
+    - value:
+        identified_by:
+          identifier_value: https://nde.nl/ontology/hc/activity/kb-digitization-medieval-2024
+        has_label: Medieval Manuscripts Digitization Project
+        has_description: "High-resolution digitization of 342 medieval manuscripts with HTR processing and metadata enhancement. IIIF-compliant output."
+        temporal_extent:
+          begin_of_the_begin: '2024-03-01'
+          end_of_the_end: '2025-12-31'
+        has_status: IN_PROGRESS
+        preceding_activity: https://nde.nl/ontology/hc/activity/kb-condition-survey-2023
+      description: Digitization project activity at a national library
     close_mappings:
     - crm:E7_Activity
     - rico:Activity
+    broad_mappings:
+    - prov:Activity
     - schema:Action
     related_mappings:
     - aat:300054277
+    structured_aliases:
+    - literal_form: activiteit
+      in_language: nl
+    - literal_form: handeling
+      in_language: nl
+    - literal_form: verrichting
+      in_language: nl
+    - literal_form: Aktivität
+      in_language: de
+    - literal_form: Tätigkeit
+      in_language: de
+    - literal_form: Vorgang
+      in_language: de
+    - literal_form: activité
+      in_language: fr
+    - literal_form: opération
+      in_language: fr
+    - literal_form: action
+      in_language: fr
+    - literal_form: actividad
+      in_language: es
+    - literal_form: operación
+      in_language: es
+    - literal_form: acción
+      in_language: es
+    - literal_form: نشاط
+      in_language: ar
+    - literal_form: إجراء
+      in_language: ar
+    - literal_form: عملية
+      in_language: ar
+    - literal_form: aktivitas
+      in_language: id
+    - literal_form: kegiatan
+      in_language: id
+    - literal_form: operasi
+      in_language: id
+    - literal_form: 活动
+      in_language: zh
+    - literal_form: 行动
+      in_language: zh
+    - literal_form: 操作
+      in_language: zh
+    keywords:
+    - action
+    - operation
+    - provenance
+    - workflow
+    - process
+    - activity
+    - curation
+    - conservation
+    - digitization
+    - cataloging
     slots:
     - identified_by
     - has_label
@@ -49,28 +177,23 @@ classes:
     - has_score
     slot_usage:
       identified_by:
-#         range: string # uriorcurie
         required: true
         identifier: true
-        inlined: false # Fixed invalid inline for primitive type
+        inlined: false
         examples:
         - value:
             identifier_value: https://nde.nl/ontology/hc/activity/rijksmuseum-inventory-2025-001
         - value:
             identifier_value: https://nde.nl/ontology/hc/activity/nationaal-archief-digitization-voc-2024
       has_label:
-#         range: string
         required: true
         examples:
         - value: 2025 Annual Collection Inventory
         - value: VOC Archives Digitization Project Phase 2
       has_description:
-#         range: string
         required: false
         examples:
-        - value: "Annual physical inventory of the Dutch Masters collection, \ncovering approximately 450 paintings. Spot-check methodology \nwith 20% sample verified against catalog records.\n"
+        - value: "Annual physical inventory of the Dutch Masters collection, covering approximately 450 paintings. Spot-check methodology with 20% sample verified against catalog records."
-        - value: CurationActivityType
-        - value: '[DigitizationActivityType, ResearchActivityType]'
       temporal_extent:
         range: TimeSpan
         required: false
@@ -80,58 +203,44 @@ classes:
             begin_of_the_begin: '2025-01-15'
             end_of_the_end: '2025-03-31'
       succeeded_by:
-#         range: string
         multivalued: true
         inlined: false
         examples:
         - value: https://nde.nl/ontology/hc/activity/conservation-treatment-2025
       has_activity:
-#         range: string
         inlined: false
         examples:
         - value: https://nde.nl/ontology/hc/activity/condition-survey-2024
       has_status:
-#         range: string
         required: false
         examples:
         - value: IN_PROGRESS
         - value: COMPLETED
         - value: PLANNED
       has_note:
-#         range: string
         multivalued: true
     annotations:
-      specificity_score: '0.50'
+      specificity_score: "0.50"
-      specificity_rationale: Moderately specific - Activity is a core domain concept but broadly applicable across all heritage custodian types.
+      specificity_rationale: "Moderately specific - Activity is a core domain concept but broadly applicable across all heritage custodian types."
       has_score: null
       custodian_types: "['*']"
+      ontological_alignment_prov: "Primary - provenance tracking"
+      ontological_alignment_crm: "E7_Activity - Cultural heritage domain"
+      ontological_alignment_rico: "Activity - Archival activities"
+      ontological_alignment_schema: "Action - Web semantics"
+      key_relationships: "has_activity_type, has_timespan, succeeded_by, preceding_activity"
+      subclasses: "CurationActivity, ConservationActivity, ExhibitionActivity, DigitizationActivity"
+      prov_properties: "prov:wasAssociatedWith, prov:used, prov:generated, prov:atTime"
     comments:
     - Base class for all heritage domain activities
-    - Extended by CurationActivity, ConservationActivity, etc.
+    - Extended by CurationActivity, ConservationActivity, ExhibitionActivity, DigitizationActivity
-    - 'Uses generic slots: has_activity_identifier, has_activity_type, has_timespan'
+    - Uses generic slots: has_activity_identifier, has_activity_type, has_timespan
     - PROV-O primary alignment for provenance tracking
     - Supports activity chaining via succeeded_by/preceding_activity
+    - Activity types organized by category: CURATION, CONSERVATION, COMMERCIAL, RESEARCH, EDUCATION, EXHIBITION, DIGITIZATION, ADMINISTRATIVE
     see_also:
     - https://www.w3.org/TR/prov-o/
     - http://www.cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E7
     - https://www.ica.org/standards/RiC/ontology
-    examples:
+    - ActivityType
-    - value:
+    - ActivityTypes
-        identified_by:
-          identifier_value: https://nde.nl/ontology/hc/activity/rijksmuseum-inventory-2025-001
-        has_label: 2025 Annual Collection Inventory - Dutch Masters
-        has_description: "Annual physical inventory of the Dutch Masters collection \n(Gallery of Honour and adjacent galleries). Spot-check methodology \nwith 20% sample verification against CMS records.\n"
-        temporal_extent:
-          begin_of_the_begin: '2025-01-15'
-          end_of_the_end: '2025-03-31'
-        has_status: IN_PROGRESS
-    - value:
-        identified_by:
-          identifier_value: https://nde.nl/ontology/hc/activity/kb-digitization-medieval-2024
-        has_label: Medieval Manuscripts Digitization Project
-        has_description: "High-resolution digitization of 342 medieval manuscripts with \nHTR processing and metadata enhancement. IIIF-compliant output.\n"
-        temporal_extent:
-          begin_of_the_begin: '2024-03-01'
-          end_of_the_end: '2025-12-31'
-        has_status: IN_PROGRESS
-        preceding_activity: https://nde.nl/ontology/hc/activity/kb-condition-survey-2023

schemas/20251121/linkml/modules/classes/ActivityType.yaml

@@ -9,7 +9,6 @@ prefixes:
   prov: http://www.w3.org/ns/prov#
   schema: http://schema.org/
   aat: http://vocab.getty.edu/aat/
-  wd: http://www.wikidata.org/entity/
 default_prefix: hc
 imports:
   - linkml:types
@@ -22,18 +21,120 @@ imports:
 classes:
   ActivityType:
     class_uri: skos:Concept
-    description: "Abstract base class for activity type classifications in the heritage domain.\n\n**DEFINITION**:\n\nActivityType represents CATEGORIES of activities performed by heritage\ncustodians, not individual activity instances. Each subclass defines\ncharacteristics of an activity category (function, typical duration,\ndeliverables, etc.).\n\n**CRITICAL: TYPE vs INSTANCE**\n\n| Aspect | ActivityType (This Class) | Activity (Instance Class) |\n|--------|---------------------------|---------------------------|\n| **Nature** | Classification/category | Individual activity |\n| **Examples** | CURATION, CONSERVATION | \"2025 Inventory at Rijksmuseum\" |\n| **Properties** | Category metadata, typical standards | Dates, responsible actors |\n| **Cardinality** | ~20-30 types | Thousands of instances |\n\n**CATEGORY STRUCTURE**:\n\nActivity types are organized into high-level categories:\n\n1. **CURATION**: Collection management activities\n   - Accessioning, Cataloging, Inventory, Deaccessioning\n\
+    description: >-
-      \   - Rehousing, Relocation, Storage Reorganization\n   \n2. **CONSERVATION**: Preservation activities\n   - Preventive Conservation, Condition Assessment\n   - Restoration, Stabilization, Environmental Monitoring\n   \n3. **COMMERCIAL**: Business activities\n   - Sales, Licensing, Merchandising\n   - Venue Rental, Event Hosting\n   \n4. **RESEARCH**: Scholarly activities\n   - Provenance Research, Cataloging Research\n   - Scientific Analysis, Documentation\n   \n5. **EDUCATION**: Educational activities\n   - Guided Tours, Workshops, Lectures\n   - Online Courses, Educational Programs\n   \n6. **EXHIBITION**: Display activities\n   - Permanent Exhibition, Temporary Exhibition\n   - Traveling Exhibition, Virtual Exhibition\n   \n7. **DIGITIZATION**: Digital transformation activities\n   - Scanning, Photography, 3D Modeling\n   - OCR/HTR Processing, Metadata Enhancement\n   \n8. **ADMINISTRATIVE**: Governance activities\n   - Audit, Valuation, Insurance\n   - Loan Management, Rights\
+      Classification category for activities performed by heritage custodians.
-      \ Management\n\n**ONTOLOGY ALIGNMENT**:\n\n- **SKOS Concept**: Activity types are concepts in a controlled vocabulary\n- **CIDOC-CRM E55_Type**: Cultural heritage domain type system\n- **AAT**: Getty Art & Architecture Thesaurus for activity terms\n- **SPECTRUM**: UK Collections Management Standard procedures\n\n**SUBCLASSES**:\n\nSee ActivityTypes.yaml for concrete activity type subclasses organized\nby category: CURATION, CONSERVATION, COMMERCIAL, RESEARCH, EDUCATION,\nEXHIBITION, DIGITIZATION, and ADMINISTRATIVE.\n"
+      
+      Abstract base class representing TYPES of activities (not individual instances).
+      Each subclass defines characteristics of an activity category including 
+      function, typical duration, deliverables, and applicable standards.
+    alt_descriptions:
+      nl:
+        text: >-
+          Classificatiecategorie voor activiteiten uitgevoerd door erfgoedbeheerders.
+          
+          Abstracte basisklasse die TYPEN activiteiten vertegenwoordigt (niet individuele instanties).
+          Elke subklasse definieert kenmerken van een activiteitscategorie inclusief 
+          functie, typische duur, producten en toepasselijke standaarden.
+      de:
+        text: >-
+          Klassifikationskategorie für Aktivitäten von Kulturgüterverwaltern.
+          
+          Abstrakte Basisklasse, die ARTEN von Aktivitäten darstellt (nicht einzelne Instanzen).
+          Jede Unterklasse definiert Merkmale einer Aktivitätskategorie einschließlich 
+          Funktion, typischer Dauer, Liefergegenständen und anwendbarer Standards.
+      fr:
+        text: >-
+          Catégorie de classification pour les activités effectuées par les dépositaires du patrimoine.
+          
+          Classe de base abstraite représentant les TYPES d'activités (pas les instances individuelles).
+          Chaque sous-classe définit les caractéristiques d'une catégorie d'activité, y compris 
+          la fonction, la durée typique, les livrables et les normes applicables.
+      es:
+        text: >-
+          Categoría de clasificación para actividades realizadas por custodios del patrimonio.
+          
+          Clase base abstracta que representa TIPOS de actividades (no instancias individuales).
+          Cada subclase define características de una categoría de actividad incluyendo 
+          función, duración típica, entregables y estándares aplicables.
+      ar:
+        text: >-
+          فئة تصنيف للأنشطة التي يقوم بها أمناء التراث.
+          
+          فئة أساسية مجردة تمثل أنواع الأنشطة (وليس الحالات الفردية).
+          كل فئة فرعية تحدد خصائص فئة النشاط بما في ذلك الوظيفة والمدة النموذجية
+          والتسليمات والمعايير المطبقة.
+      id:
+        text: >-
+          Kategori klasifikasi untuk aktivitas yang dilakukan oleh pengelola warisan.
+          
+          Kelas dasar abstrak yang mewakili JENIS aktivitas (bukan instance individual).
+          Setiap subkelas mendefinisikan karakteristik kategori aktivitas termasuk 
+          fungsi, durasi tipikal, deliverabel, dan standar yang berlaku.
+      zh:
+        text: >-
+          遗产保管人执行活动的分类类别。
+          
+          抽象基类，表示活动类型（而非单个实例）。
+          每个子类定义活动类别的特征，包括功能、典型持续时间、交付物和适用标准。
+    examples:
+    - value:
+        identified_by:
+        - https://nde.nl/ontology/hc/activity-type/curation
+        has_label:
+        - Curation@en
+        - curatie@nl
+        has_description: Activities related to ongoing collection management
+      description: Curation activity type classification
     abstract: true
-    exact_mappings:
-    - skos:Concept
     close_mappings:
-    - crm:E55_Type
     - schema:DefinedTerm
+    broad_mappings:
+    - skos:Concept
+    - crm:E55_Type
     related_mappings:
     - prov:Activity
     - aat:300054277
+    structured_aliases:
+    - literal_form: activiteittype
+      in_language: nl
+    - literal_form: activiteitscategorie
+      in_language: nl
+    - literal_form: Aktivitätstyp
+      in_language: de
+    - literal_form: Aktivitätskategorie
+      in_language: de
+    - literal_form: type d'activité
+      in_language: fr
+    - literal_form: catégorie d'activité
+      in_language: fr
+    - literal_form: tipo de actividad
+      in_language: es
+    - literal_form: categoría de actividad
+      in_language: es
+    - literal_form: نوع النشاط
+      in_language: ar
+    - literal_form: فئة النشاط
+      in_language: ar
+    - literal_form: tipe aktivitas
+      in_language: id
+    - literal_form: kategori aktivitas
+      in_language: id
+    - literal_form: 活动类型
+      in_language: zh
+    - literal_form: 活动类别
+      in_language: zh
+    keywords:
+    - activity type
+    - classification
+    - category
+    - curation
+    - conservation
+    - digitization
+    - cataloging
+    - exhibition
+    - research
+    - education
+    - administrative
     slots:
     - begin_of_the_begin
     - updated_at
@@ -43,24 +144,21 @@ classes:
     - has_label
     slot_usage:
       identified_by:
-#         range: string # uriorcurie
         required: true
         identifier: true
         multivalued: true
         examples:
         - value: https://nde.nl/ontology/hc/activity-type/curation
-        - value: wd:Q1348059
+        - value: https://nde.nl/ontology/hc/activity-type/conservation
       has_label:
-#         range: string
         required: true
         multivalued: true
         examples:
         - value:
           - Curation@en
           - curatie@nl
-          - Kuration@de
+          - Kuratierung@de
       has_description:
-#         range: string
         required: false
         examples:
         - value: Activities related to the ongoing management and care of collections
@@ -69,27 +167,23 @@ classes:
       updated_at:
         range: datetime
     annotations:
-      specificity_score: '0.40'
+      specificity_score: "0.40"
-      specificity_rationale: Moderately specific - activity types are domain-relevant but not specific to any single conversation template.
+      specificity_rationale: "Moderately specific - activity types are domain-relevant but not specific to any single custodian type."
       has_score: null
       custodian_types: "['*']"
+      activity_categories: "CURATION, CONSERVATION, COMMERCIAL, RESEARCH, EDUCATION, EXHIBITION, DIGITIZATION, ADMINISTRATIVE"
+      type_vs_instance: "ActivityType = classification; Activity = individual activity instance"
+      spectrum_alignment: "UK Collections Management Standard procedures"
     comments:
     - Abstract base class - use specific subclasses (CurationType, ConservationType, etc.)
     - Represents ACTIVITY TYPES, not activity instances
     - Activity.has_activity_type references these type classes
     - Follows Type/Types naming convention (Rule 0b)
     - Organized by function, domain, and typical characteristics
+    - Activity types organized into 8 categories: CURATION, CONSERVATION, COMMERCIAL, RESEARCH, EDUCATION, EXHIBITION, DIGITIZATION, ADMINISTRATIVE
     see_also:
-    - https://www.wikidata.org/
     - https://www.w3.org/2004/02/skos/
     - http://vocab.getty.edu/aat/
     - https://collectionstrust.org.uk/spectrum/
-    examples:
+    - Activity
-    - value:
+    - ActivityTypes
-        identified_by:
-        - https://nde.nl/ontology/hc/activity-type/curation
-        - wd:Q1348059
-        has_label:
-        - Curation@en
-        - curatie@nl
-        has_description: Activities related to ongoing collection management

schemas/20251121/linkml/modules/classes/ActivityTypes.yaml

@@ -1,10 +1,13 @@
 id: https://nde.nl/ontology/hc/class/ActivityTypes
 name: ActivityTypes
-title: ActivityTypes
+title: Activity Types Container
 description: Container for ActivityType instances.
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  crm: http://www.cidoc-crm.org/cidoc-crm/
+  schema: http://schema.org/
 default_prefix: hc
 imports:
   - ./ActivityType
@@ -12,12 +15,65 @@ imports:
 classes:
   ActivityTypes:
     class_uri: hc:ActivityTypes
-    description: Activity types container.
+    description: >-
-    annotations:
+      Container class for ActivityType instances.
-      specificity_score: 0.1
+      
-      specificity_rationale: Generic utility class created during migration
+      Provides a root node for grouping activity type classifications 
-      custodian_types: '["*"]'
+      in the heritage custodian ontology hierarchy.
+    alt_descriptions:
+      nl:
+        text: Containerklasse voor ActivityType-instanties.
+      de:
+        text: Containerklasse für ActivityType-Instanzen.
+      fr:
+        text: Classe conteneur pour les instances ActivityType.
+      es:
+        text: Clase contenedora para instancias de ActivityType.
+      ar:
+        text: فئة حاوية لمثيلات ActivityType.
+      id:
+        text: Kelas kontainer untuk instance ActivityType.
+      zh:
+        text: ActivityType实例的容器类。
+    examples:
+    - value:
+        activity_types:
+        - https://nde.nl/ontology/hc/activity-type/curation
+        - https://nde.nl/ontology/hc/activity-type/conservation
+        - https://nde.nl/ontology/hc/activity-type/digitization
+      description: Container holding references to activity type classifications
     tree_root: true
     broad_mappings:
-    - crm:E7_Activity
+    - skos:Collection
-    - schema:Action
+    - skos:Concept
+    - crm:E55_Type
+    - schema:Enumeration
+    structured_aliases:
+    - literal_form: activiteitstypen
+      in_language: nl
+    - literal_form: Aktivitätstypen
+      in_language: de
+    - literal_form: types d'activité
+      in_language: fr
+    - literal_form: tipos de actividad
+      in_language: es
+    - literal_form: أنواع الأنشطة
+      in_language: ar
+    - literal_form: tipe aktivitas
+      in_language: id
+    - literal_form: 活动类型
+      in_language: zh
+    keywords:
+    - activity types
+    - container
+    - classification
+    annotations:
+      specificity_score: "0.10"
+      specificity_rationale: "Generic utility container class for grouping activity types."
+      custodian_types: "['*']"
+    comments:
+    - Container class for grouping ActivityType instances
+    - Used as tree_root for activity type hierarchy
+    see_also:
+    - ActivityType
+    - Activity

schemas/20251121/linkml/modules/classes/Actor.yaml

@@ -1,11 +1,14 @@
 id: https://nde.nl/ontology/hc/class/Actor
 name: Actor
 title: Actor
-description: An actor involved in an event or activity.
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
   prov: http://www.w3.org/ns/prov#
+  schema: http://schema.org/
+  crm: http://www.cidoc-crm.org/cidoc-crm/
+  rico: https://www.ica.org/standards/RiC/ontology#
+  foaf: http://xmlns.com/foaf/0.1/
 default_prefix: hc
 imports:
   - linkml:types
@@ -14,11 +17,135 @@ imports:
 classes:
   Actor:
     class_uri: prov:Agent
-    description: Involved actor.
+    description: >-
+      Agent involved in an event, activity, or provenance chain.
+      
+      Represents any entity that bears some form of responsibility for an 
+      activity taking place, for the existence of an entity, or for another 
+      agent's activity. May be a person, organization, or software agent.
+    alt_descriptions:
+      nl:
+        text: >-
+          Agent betrokken bij een gebeurtenis, activiteit of herkomstketen.
+          
+          Vertegenwoordigt elke entiteit die enige vorm van verantwoordelijkheid draagt 
+          voor een activiteit, voor het bestaan van een entiteit, of voor de activiteit 
+          van een andere agent. Kan een persoon, organisatie of software-agent zijn.
+      de:
+        text: >-
+          Akteur, der an einem Ereignis, einer Aktivität oder einer Provenienzkette beteiligt ist.
+          
+          Repräsentiert jede Entität, die eine gewisse Verantwortung für eine Aktivität, 
+          für die Existenz einer Entität oder für die Aktivität eines anderen Akteurs trägt. 
+          Kann eine Person, Organisation oder Software-Agent sein.
+      fr:
+        text: >-
+          Agent impliqué dans un événement, une activité ou une chaîne de provenance.
+          
+          Représente toute entité qui assume une forme de responsabilité pour qu'une 
+          activité ait lieu, pour l'existence d'une entité, ou pour l'activité d'un autre agent. 
+          Peut être une personne, une organisation ou un agent logiciel.
+      es:
+        text: >-
+          Agente involucrado en un evento, actividad o cadena de procedencia.
+          
+          Representa cualquier entidad que tiene alguna forma de responsabilidad por 
+          una actividad, por la existencia de una entidad, o por la actividad de otro agente. 
+          Puede ser una persona, organización o agente de software.
+      ar:
+        text: >-
+          وكيل مشارك في حدث أو نشاط أو سلسلة أصل.
+          
+          يمثل أي كيان يتحمل شكلاً من أشكال المسؤولية عن نشاط ما، أو عن وجود كيان، 
+          أو عن نشاط وكيل آخر. يمكن أن يكون شخصًا أو منظمة أو وكيل برمجيات.
+      id:
+        text: >-
+          Agen yang terlibat dalam peristiwa, aktivitas, atau rantai provenans.
+          
+          Mewakili entitas apa pun yang memikul bentuk tanggung jawab untuk suatu aktivitas, 
+          untuk keberadaan suatu entitas, atau untuk aktivitas agen lain. 
+          Dapat berupa orang, organisasi, atau agen perangkat lunak.
+      zh:
+        text: >-
+          参与事件、活动或来源链的代理。
+          
+          代表对活动发生、实体存在或其他代理活动承担某种形式责任的任何实体。
+          可以是个人、组织或软件代理。
+    examples:
+    - value:
+        has_name: Dr. Maria van der Berg
+        has_role: Conservator
+      description: Person acting as collection conservator
+    - value:
+        has_name: Rijksmuseum Conservation Department
+        has_role: Responsible Department
+      description: Organization acting in conservation activities
+    close_mappings:
+    - crm:E39_Actor
+    - rico:Agent
+    - foaf:Agent
+    broad_mappings:
+    - prov:Agent
+    - schema:Thing
+    structured_aliases:
+    - literal_form: actor
+      in_language: nl
+    - literal_form: agent
+      in_language: nl
+    - literal_form: Akteur
+      in_language: de
+    - literal_form: Agent
+      in_language: de
+    - literal_form: acteur
+      in_language: fr
+    - literal_form: agent
+      in_language: fr
+    - literal_form: actor
+      in_language: es
+    - literal_form: agente
+      in_language: es
+    - literal_form: فاعل
+      in_language: ar
+    - literal_form: وكيل
+      in_language: ar
+    - literal_form: aktor
+      in_language: id
+    - literal_form: agen
+      in_language: id
+    - literal_form: 行为者
+      in_language: zh
+    - literal_form: 代理
+      in_language: zh
+    keywords:
+    - agent
+    - actor
+    - person
+    - organization
+    - provenance
+    - responsibility
     slots:
     - has_name
     - has_role
+    slot_usage:
+      has_name:
+        required: true
+        examples:
+        - value: Dr. Maria van der Berg
+        - value: Rijksmuseum Conservation Department
+      has_role:
+        required: false
+        examples:
+        - value: Conservator
+        - value: Responsible Department
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.10"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: "Generic utility class - actors are broadly applicable across all provenance contexts."
       custodian_types: "['*']"
+      actor_types: "Person, Organization, SoftwareAgent"
+    comments:
+    - Base class for all agents in provenance tracking
+    - Specialized by Person, Organization, and SoftwareAgent in PROV-O
+    - Used in Activity.associated_with and Entity.attributed_to relationships
+    see_also:
+    - https://www.w3.org/TR/prov-o/#Agent
+    - Activity

schemas/20251121/linkml/modules/classes/Address.yaml

@@ -20,115 +20,158 @@ imports:
   - ../slots/has_label
   - ../slots/has_section
   - ../slots/has_type
-  - ../slots/derive_from # was: was_derived_from
+  - ../slots/derive_from
-  - ../slots/generated_by  # was: was_generated_by
+  - ../slots/generated_by
   - ../slots/located_in
   - ../slots/has_latitude
   - ../slots/has_locality
   - ../slots/has_longitude
   - ../slots/has_postal_code
   - ../slots/has_geographic_subdivision
-# default_range: string
 classes:
   Address:
     class_uri: vcard:Address
-    description: |
+    description: >-
       Physical or postal address for heritage custodians and related entities.
-      **ONTOLOGY ALIGNMENT**:
+      
-      This class aligns with multiple established address ontologies:
+      Structured representation of location data following vCard (RFC6350), 
-      | Ontology | Class | Notes |
+      Schema.org, and EU Location Core Vocabulary standards. Supports both 
-      |----------|-------|-------|
+      formatted string representation and component-based structured data.
-      | **vCard** | `vcard:Address` | RFC6350 ADR property components |
+    alt_descriptions:
-      | **Schema.org** | `schema:PostalAddress` | Web semantics |
+      nl:
-      | **LOCN** | `locn:Address` | EU Location Core Vocabulary |
+        text: >-
-      | **GLEIF** | `gleif_base:PhysicalAddress` | Legal entity addresses |
+          Fysiek of postadres voor erfgoedbeheerders en gerelateerde entiteiten.
-      **COMPONENT STRUCTURE**:
+          
-      An address consists of hierarchical components:
+          Gestructureerde weergave van locatiegegevens volgens vCard (RFC6350), 
-      ```
+          Schema.org en EU Location Core Vocabulary standaarden. Ondersteunt zowel 
-      Address
+          geformatteerde tekenreeksweergave als componentgebaseerde gestructureerde gegevens.
-      ├── has_section (e.g., "1", "221B", "25-27")
+      de:
-      ├── has_label  (street name as Label, e.g., "Museumstraat")
+        text: >-
-      ├── postal_code       (e.g., "1071 XX")
+          Physische oder Postadresse für Kulturgüterverwalter und verwandte Entitäten.
-      ├── locality          (e.g., "Amsterdam")
+          
-      ├── region            (e.g., "Noord-Holland", "NL-NH")
+          Strukturierte Darstellung von Standortdaten nach vCard (RFC6350), 
-      ├── country_name      (e.g., "Netherlands", "NL")
+          Schema.org und EU Location Core Vocabulary Standards. Unterstützt sowohl 
-      └── has_label  (formatted address as Label)
+          formatierte Zeichenkettendarstellung als auch komponentenbasierte strukturierte Daten.
-      ```
+      fr:
-      NOTE: street_name slot migrated to has_label + Label (2026-01-17, Rule 53/56)
+        text: >-
-      NOTE: street_address slot removed - was redundant string; use house_number + has_label (2026-01-17, Rule 53/56)
+          Adresse physique ou postale pour les dépositaires du patrimoine et entités connexes.
-      **ADDRESS TYPES FOR HERITAGE CUSTODIANS**:
+          
-      | Type | Use Case |
+          Représentation structurée des données de localisation selon les normes vCard (RFC6350), 
-      |------|----------|
+          Schema.org et EU Location Core Vocabulary. Prend en charge à la fois 
-      | `HEADQUARTERS` | Main organizational address |
+          la représentation sous forme de chaîne formatée et les données structurées basées sur les composants.
-      | `LEGAL` | Registered legal/business address |
+      es:
-      | `VISITING` | Public visitor entrance |
+        text: >-
-      | `MAILING` | Correspondence/postal address |
+          Dirección física o postal para custodios del patrimonio y entidades relacionadas.
-      | `STORAGE` | Depot, warehouse, off-site storage |
+          
-      | `BRANCH` | Branch office location |
+          Representación estructurada de datos de ubicación según los estándares vCard (RFC6350), 
-      **USAGE EXAMPLES**:
+          Schema.org y EU Location Core Vocabulary. Admite tanto la representación de cadena 
-      ```yaml
+          formateada como datos estructurados basados en componentes.
-      # Simple address with formatted string
+      ar:
-      has_address:
+        text: >-
-        - address_formatted: "Museumstraat 1, 1071 XX Amsterdam, Netherlands"
+          عنوان فعلي أو بريدي لأمناء التراث والكيانات ذات الصلة.
-          address_type: HEADQUARTERS
+          
-      # Structured address with components
+          تمثيل منظم لبيانات الموقع وفقًا لمعايير vCard (RFC6350) وSchema.org 
-      has_address:
+          ومفردات الموقع الأساسية للاتحاد الأوروبي. يدعم كل من تمثيل السلسلة المنسقة 
-        - has_label:
+          والبيانات المنظمة القائمة على المكونات.
-            - has_label: "Museumstraat"
+      id:
-              language: "nl"
+        text: >-
-          has_section:
+          Alamat fisik atau pos untuk pengelola warisan dan entitas terkait.
-            - has_value: "1"
+          
-          postal_code: "1071 XX"
+          Representasi terstruktur dari data lokasi mengikuti standar vCard (RFC6350), 
-          locality: "Amsterdam"
+          Schema.org, dan EU Location Core Vocabulary. Mendukung representasi string 
-          region: "Noord-Holland"
+          yang diformat dan data terstruktur berbasis komponen.
-          country_name: "NL"
+      zh:
-          address_type: HEADQUARTERS
+        text: >-
-          latitude: 52.3600
+          遗产保管人及相关实体的物理或邮政地址。
-          longitude: 4.8852
+          
-          geonames_id: 2759794
+          遵循 vCard (RFC6350)、Schema.org 和欧盟位置核心词汇标准的结构化位置数据表示。
-      ```
+          支持格式化字符串表示和基于组件的结构化数据。
-      **RELATIONSHIP TO OTHER CLASSES**:
+    examples:
-      - `AuxiliaryPlace`: Uses Address for structured address data
+    - value:
-      - `CustodianPlace`: May reference Address for place location
+        has_section:
-      - `ContactPoint`: Uses Address for contact location
+        - has_value: "1"
-      - `Settlement`/`Subregion`/`Country`: Hierarchical geographic entities
+        has_label:
-      **PROVENANCE**:
+        - has_label: Museumstraat
-      Address data may be extracted from various sources (websites, Google Maps, 
+          language: nl
-      registries). Track provenance with:
+        - has_label: Museumstraat 1, 1071 XX Amsterdam, Netherlands
-      - `was_derived_from`: Link to source observation
+          language: nl
-      - `generated_by`: Link to extraction activity
+        has_postal_code: "1071 XX"
-    exact_mappings:
+        has_locality: Amsterdam
-      - vcard:Address
+        has_geographic_subdivision: Noord-Holland
+        in_country: NL
+        has_latitude: 52.36
+        has_longitude: 4.8852
+        has_type: HeadquartersAddress
+      description: Rijksmuseum headquarters address with structured components
+    - value:
+        has_label:
+        - has_label: 1600 Pennsylvania Avenue NW, Washington, DC 20500, USA
+          language: en
+        has_locality: Washington
+        has_geographic_subdivision: DC
+        in_country: US
+      description: Simple formatted address for US location
+    broad_mappings:
+    - vcard:Address
     close_mappings:
-      - schema:PostalAddress
+    - schema:PostalAddress
-      - locn:Address
+    - locn:Address
-      - gleif_base:PhysicalAddress
+    - gleif_base:PhysicalAddress
     related_mappings:
-      - org:siteAddress
+    - org:siteAddress
-      - schema:address
+    - schema:address
+    structured_aliases:
+    - literal_form: adres
+      in_language: nl
+    - literal_form: postadres
+      in_language: nl
+    - literal_form: Adresse
+      in_language: de
+    - literal_form: Postanschrift
+      in_language: de
+    - literal_form: adresse
+      in_language: fr
+    - literal_form: adresse postale
+      in_language: fr
+    - literal_form: dirección
+      in_language: es
+    - literal_form: dirección postal
+      in_language: es
+    - literal_form: عنوان
+      in_language: ar
+    - literal_form: عنوان بريدي
+      in_language: ar
+    - literal_form: alamat
+      in_language: id
+    - literal_form: alamat pos
+      in_language: id
+    - literal_form: 地址
+      in_language: zh
+    - literal_form: 邮政地址
+      in_language: zh
+    keywords:
+    - address
+    - location
+    - street
+    - postal code
+    - city
+    - country
+    - headquarters
+    - visiting address
+    - storage address
     slots:
-      # Street-level components
+    - has_section
-      - has_section
+    - has_postal_code
-      # REMOVED: street_name - migrated to has_label + Label (2026-01-17, Rule 53/56)
+    - has_locality
-      # REMOVED: street_address - redundant string slot; use house_number + has_label (2026-01-17, Rule 53/56)
+    - located_in
-      # Postal components
+    - has_geographic_subdivision
-      - has_postal_code
+    - in_country
-      # Locality/geographic hierarchy
+    - has_label
-      - has_locality
+    - has_type
-      # REMOVED: city - migrated to located_in + City (2026-01-18, Rule 53)
+    - has_latitude
-      - located_in
+    - has_longitude
-      - has_geographic_subdivision
+    - derive_from
-      - in_country
+    - generated_by
-      # Formatted representation (MIGRATED: address_formatted → has_label)
-      - has_label
-      # Classification (MIGRATED: address_type → has_type)
-      - has_type
-      # Geographic coordinates (for geocoded addresses)
-      - has_latitude
-      - has_longitude
-      # Provenance
-      - derive_from  # was: was_derived_from - migrated per Rule 53
-      - generated_by  # was: was_generated_by - migrated per Rule 53
     slot_usage:
       has_section:
         range: HouseNumber
@@ -138,139 +181,87 @@ classes:
             has_value: "1"
         - value:
             has_value: "221B"
-      # REMOVED: street_name slot_usage - migrated to has_label + Label (2026-01-17, Rule 53/56)
-      # Street names should now use Label class with language tagging via has_label
-      # REMOVED: street_address slot_usage - redundant string slot removed (2026-01-17, Rule 53/56)
-      # Use house_number + has_label (street name as Label) instead of combined string
       has_postal_code:
-#         range: string
         required: false
         examples:
-          - value: "1071 XX"
+        - value: "1071 XX"
       has_locality:
-#         range: string
         required: false
         examples:
-          - value: "Amsterdam"
+        - value: Amsterdam
-      # REMOVED: city slot_usage - migrated to located_in + City (2026-01-18, Rule 53)
-      # city:
-      #   range: string
-      #   required: false
-      #   description: Alternative slot for locality (schema:addressLocality)
       located_in:
-#         range: string
         required: false
-        inlined: false # Fixed invalid inline for primitive type
+        inlined: false
         examples:
-          - value:
+        - value:
-              settlement_name: "Amsterdam"
+            settlement_name: Amsterdam
-              country: "NL"
+            country: NL
       has_geographic_subdivision:
-#         range: string
         required: false
         examples:
-          - value: "Noord-Holland"
+        - value: Noord-Holland
-          - value: "NL-NH"
+        - value: NL-NH
       in_country:
-#         range: string
         required: false
         examples:
-          - value: "Netherlands"
+        - value: Netherlands
-          - value: "NL"
+        - value: NL
-      # REMOVED 2026-01-22: address_formatted - migrated to has_label + Label (Rule 53, Feedback F1)
+      has_label:
-      # Formatted address strings now use has_label slot_usage below
-      # REMOVED: address_type slot_usage - migrated to has_type (2026-01-17, Rule 53/56)
-      has_label:  # was: address_formatted + street_name - migrated per Rule 53 (2026-01-17, 2026-01-22)
-#         range: string
         multivalued: true
-        inlined: false # Fixed invalid inline for primitive type
+        inlined: false
-        inlined_as_list: false # Fixed invalid inline for primitive type
+        inlined_as_list: false
         required: false
         examples:
-          - value:
+        - value:
-              - has_label: "Museumstraat"
+          - has_label: Museumstraat
-                language: "nl"
+            language: nl
-              - has_label: "Museumstraat 1, 1071 XX Amsterdam, Netherlands"
+          - has_label: Museumstraat 1, 1071 XX Amsterdam, Netherlands
-                language: "nl"
+            language: nl
-      has_type:  # was: address_type - migrated per Rule 53/56 (2026-01-17)
+      has_type:
         range: AddressType
         required: false
         multivalued: false
         examples:
-          - value: HeadquartersAddress
+        - value: HeadquartersAddress
       has_latitude:
         range: float
         required: false
         examples:
-          - value: 52.3600
+        - value: 52.36
       has_longitude:
         range: float
         required: false
         examples:
-          - value: 4.8852
+        - value: 4.8852
-          - value: 2759794
+      derived_from:
-      derived_from:  # was: was_derived_from - migrated per Rule 53
-#         range: string # CustodianObservation
         multivalued: true
         required: false
-      generated_by:  # was: was_generated_by - migrated per Rule 53
+      generated_by:
         range: ReconstructionActivity
         required: false
-    comments:
-      - vCard Address is the primary ontology class (RFC6350 standard)
-      - Use structured components when available, address_formatted as fallback
-      - Multiple addresses supported via has_address slot (multivalued, Rule 39 compliant)
-      - address_type distinguishes headquarters, legal, visiting, mailing, storage
-      - Coordinates (lat/lon) optional but recommended for visualization/mapping
-    see_also:
-      - https://www.w3.org/TR/vcard-rdf/#d4e936
-      - https://schema.org/PostalAddress
-      - https://www.w3.org/ns/locn#Address
-      - https://www.gleif.org/ontology/Base/PhysicalAddress
-    examples:
-      - value:
-          has_section:
-            - has_value: "1"
-          has_label:
-            - has_label: "Museumstraat"
-              language: "nl"
-            - has_label: "Museumstraat 1, 1071 XX Amsterdam, Netherlands"
-              language: "nl"
-          # REMOVED: street_address - migrated to house_number + has_label (2026-01-17, Rule 53/56)
-          postal_code: "1071 XX"
-          locality: "Amsterdam"
-          region: "Noord-Holland"
-          country_name: "NL"
-          latitude: 52.3600
-          longitude: 4.8852
-      - value:
-          has_section:
-            - has_value: "40"
-          # REMOVED: street_address - migrated to house_number + has_label (2026-01-17, Rule 53/56)
-          postal_code: "2011 RX"
-          locality: "Haarlem"
-          country_name: "NL"
-      - value:
-          has_label:
-            - has_label: "1600 Pennsylvania Avenue NW, Washington, DC 20500, USA"
-              language: "en"
-          locality: "Washington"
-          region: "DC"
-          country_name: "US"
-      - value:
-          has_label:
-            - has_label: "Euterpelaan"
-              language: "nl"
-            - has_label: "Euterpelaan 25, 3824 BK Amersfoort, Netherlands"
-              language: "nl"
-          has_section:
-            - has_value: "25"
-          postal_code: "3824 BK"
-          locality: "Amersfoort"
-          region: "Utrecht"
-          country_name: "NL"
     annotations:
-      specificity_score: 0.25
+      specificity_score: "0.25"
       specificity_rationale: "Address is broadly applicable to all heritage custodian types and many other entities. Universal across domains."
-      custodian_types: '["*"]'
+      custodian_types: "['*']"
       custodian_types_rationale: "All heritage custodians have physical addresses - museums, archives, libraries, etc."
+      address_types: "HEADQUARTERS, LEGAL, VISITING, MAILING, STORAGE, BRANCH, READING_ROOM"
+      ontology_alignment_vcard: "RFC6350 ADR property components"
+      ontology_alignment_schema: "Web semantics"
+      ontology_alignment_locn: "EU Location Core Vocabulary"
+      ontology_alignment_gleif: "Legal entity addresses"
+    comments:
+    - vCard Address is the primary ontology class (RFC6350 standard)
+    - Use structured components when available, formatted string as fallback
+    - Multiple addresses supported via has_address slot (multivalued, Rule 39 compliant)
+    - Address types distinguish headquarters, legal, visiting, mailing, storage
+    - Coordinates (lat/lon) optional but recommended for visualization/mapping
+    - street_name migrated to has_label + Label (2026-01-17, Rule 53/56)
+    - street_address removed - use house_number + has_label instead
+    see_also:
+    - https://www.w3.org/TR/vcard-rdf/#d4e936
+    - https://schema.org/PostalAddress
+    - https://www.w3.org/ns/locn#Address
+    - https://www.gleif.org/ontology/Base/PhysicalAddress
+    - AddressType
+    - AddressTypes
+    - AddressComponent

schemas/20251121/linkml/modules/classes/AddressComponent.yaml

@@ -1,6 +1,6 @@
 id: https://nde.nl/ontology/hc/classes/AddressComponent
 name: AddressComponent
-title: AddressComponent
+title: Address Component
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
@@ -12,64 +12,150 @@ imports:
   - ../slots/has_type
   - ../slots/has_literal_form
   - ../slots/shortened_as
-# default_range: string
 classes:
   AddressComponent:
     class_uri: hc:AddressComponent
-    description: "A single component of a structured address.\n\n**PURPOSE**:\n\n\
+    description: >-
-      AddressComponent represents one discrete element of an address, such as \nthe\
+      Single component of a structured address.
-      \ street number, street name, city, region, or country. This enables:\n- Parsing\
+      
-      \ addresses from various sources into standardized components\n- Normalizing\
+      Represents one discrete element of an address such as street number, 
-      \ address data from different formats/APIs\n- Supporting multilingual address\
+      street name, city, region, or country. Used for parsing addresses from 
-      \ representations (long_name vs short_name)\n\n**COMPONENT STRUCTURE**:\n\n\
+      various sources into standardized components and normalizing address 
-      Each AddressComponent has:\n- `long_name`: Full form of the value (e.g., \"\
+      data from different formats/APIs.
-      Netherlands\", \"Noord-Holland\")\n- `short_name`: Abbreviated form (e.g., \"\
+    alt_descriptions:
-      NL\", \"NH\") - may equal long_name\n- `has_type`: Semantic type(s) via\
+      nl:
-      \ ComponentType (e.g., Country, Locality)\n\n**STANDARD COMPONENT TYPES**:\n\
+        text: >-
-      \n| Type | Description | Example long_name | Example short_name |\n|------|-------------|-------------------|-------------------|\n\
+          Enkel onderdeel van een gestructureerd adres.
-      | `street_number` | House/building number | \"1\", \"221B\" | same |\n| `route`\
+          
-      \ | Street/road name | \"Museumstraat\" | same |\n| `locality` | City/town/village\
+          Vertegenwoordigt één discreet element van een adres zoals huisnummer, 
-      \ | \"Amsterdam\" | same |\n| `postal_code` | ZIP/postal code | \"1071 XX\"\
+          straatnaam, stad, regio of land. Gebruikt voor het parseren van adressen 
-      \ | same |\n| `subregion` | County/district | \"Amsterdam\" | same |\n| `region`\
+          uit verschillende bronnen naar gestandaardiseerde componenten en het 
-      \ | State/province | \"Noord-Holland\" | \"NH\" |\n| `country` | Country | \"\
+          normaliseren van adresgegevens uit verschillende formaten/API's.
-      Netherlands\" | \"NL\" |\n| `premise` | Building/complex name | \"Rijksmuseum\"\
+      de:
-      \ | same |\n| `subpremise` | Unit/floor/suite | \"Floor 3\" | \"3\" |\n\n**RELATIONSHIP\
+        text: >-
-      \ TO Address CLASS**:\n\nAddressComponent is used for:\n1. **Parsing workflows**:\
+          Einzelne Komponente einer strukturierten Adresse.
-      \ Breaking down raw address strings into components\n2. **Normalization**: Standardizing\
+          
-      \ addresses from different sources\n3. **Intermediate representation**: Before\
+          Repräsentiert ein diskretes Element einer Adresse wie Hausnummer, 
-      \ constructing a full Address object\n\nThe Address class provides the final,\
+          Straßenname, Stadt, Region oder Land. Wird zum Parsen von Adressen 
-      \ ontology-aligned representation with \ndedicated slots (street_name, locality,\
+          aus verschiedenen Quellen in standardisierte Komponenten und zum 
-      \ region, country_name, etc.).\n\n```\nRaw Address Data (any source)\n    │\n\
+          Normalisieren von Adressdaten aus verschiedenen Formaten/APIs verwendet.
-      \    └── parse → AddressComponent[]  # Intermediate representation\n       \
+      fr:
-      \             │\n                    └── normalize → Address  # vCard/LOCN aligned\n\
+        text: >-
-      ```\n\n**USAGE EXAMPLES**:\n\n```yaml\n# Street number component (MIGRATED 2026-01-22:\
+          Composant unique d'une adresse structurée.
-      \ Rule 53)\n- long_name: \"1\"\n  short_name: \"1\"\n  has_type: [StreetNumber]\n\
+          
-      \n# Province with abbreviation\n- long_name: \"Noord-Holland\"\n  short_name:\
+          Représente un élément discret d'une adresse tel que le numéro de rue, 
-      \ \"NH\"\n  has_type: [Region]\n\n# Country with ISO code\n- long_name:\
+          le nom de rue, la ville, la région ou le pays. Utilisé pour analyser 
-      \ \"Netherlands\"\n  short_name: \"NL\"\n  has_type: [Country]\n```\n\
+          les adresses de diverses sources en composants standardisés et normaliser 
-      \n**SOURCE-AGNOSTIC DESIGN**:\n\nThis class is designed to work with addresses\
+          les données d'adresse de différents formats/API.
-      \ from ANY source:\n- Website scraping\n- Registry data (ISIL, KvK, etc.)\n\
+      es:
-      - API responses (when normalized)\n- Manual data entry\n- OCR/document extraction\n\
+        text: >-
-      \nAPI-specific raw data formats are handled by Endpoint classes.\n"
+          Componente único de una dirección estructurada.
+          
+          Representa un elemento discreto de una dirección como número de calle, 
+          nombre de calle, ciudad, región o país. Se utiliza para analizar direcciones 
+          de varias fuentes en componentes estandarizados y normalizar datos de 
+          direcciones de diferentes formatos/API.
+      ar:
+        text: >-
+          مكون واحد من عنوان منظم.
+          
+          يمثل عنصرًا منفصلًا من العنوان مثل رقم الشارع واسم الشارع والمدينة 
+          أو المنطقة أو البلد. يُستخدم لتحليل العناوين من مصادر مختلفة إلى 
+          مكونات موحدة وتطبيع بيانات العناوين من تنسيقات/واجهات برمجة تطبيقات مختلفة.
+      id:
+        text: >-
+          Komponen tunggal dari alamat terstruktur.
+          
+          Mewakili satu elemen diskrit dari alamat seperti nomor jalan, nama jalan, 
+          kota, wilayah, atau negara. Digunakan untuk mengurai alamat dari berbagai 
+          sumber menjadi komponen terstandarisasi dan menormalkan data alamat dari 
+          format/API yang berbeda.
+      zh:
+        text: >-
+          结构化地址的单个组件。
+          
+          表示地址的一个离散元素，如街道号码、街道名称、城市、地区或国家。
+          用于将来自各种来源的地址解析为标准化组件，并规范化来自不同格式/API的地址数据。
+    examples:
+    - value:
+        has_literal_form: '1'
+        shortened_as: '1'
+        has_type:
+        - StreetNumber
+      description: Street number component
+    - value:
+        has_literal_form: Museumstraat
+        shortened_as: Museumstraat
+        has_type:
+        - Route
+      description: Street name component
+    - value:
+        has_literal_form: Noord-Holland
+        shortened_as: NH
+        has_type:
+        - Region
+      description: Province/region component with abbreviation
+    - value:
+        has_literal_form: Netherlands
+        shortened_as: NL
+        has_type:
+        - Country
+      description: Country component with ISO code
     close_mappings:
     - locn:AddressRepresentation
     related_mappings:
     - schema:PostalAddress
     - vcard:Address
+    structured_aliases:
+    - literal_form: adrescomponent
+      in_language: nl
+    - literal_form: adresonderdeel
+      in_language: nl
+    - literal_form: Adresskomponente
+      in_language: de
+    - literal_form: Adressbestandteil
+      in_language: de
+    - literal_form: composant d'adresse
+      in_language: fr
+    - literal_form: élément d'adresse
+      in_language: fr
+    - literal_form: componente de dirección
+      in_language: es
+    - literal_form: elemento de dirección
+      in_language: es
+    - literal_form: مكون العنوان
+      in_language: ar
+    - literal_form: عنصر العنوان
+      in_language: ar
+    - literal_form: komponen alamat
+      in_language: id
+    - literal_form: elemen alamat
+      in_language: id
+    - literal_form: 地址组件
+      in_language: zh
+    - literal_form: 地址元素
+      in_language: zh
+    keywords:
+    - address component
+    - street number
+    - locality
+    - region
+    - country
+    - postal code
+    - parsing
+    - normalization
     slots:
     - has_literal_form
     - shortened_as
     - has_type
     slot_usage:
       has_literal_form:
-#         range: string
         required: false
         examples:
         - value: Netherlands
         - value: Noord-Holland
         - value: Museumstraat
       shortened_as:
-#         range: string
         required: false
         examples:
         - value: NL
@@ -85,49 +171,18 @@ classes:
         - value: Locality
         - value: Region
         - value: Country
+    annotations:
+      specificity_score: "0.35"
+      specificity_rationale: "Generic address parsing component. Broadly applicable across all address sources and custodian types."
+      custodian_types: "['*']"
+      custodian_types_rationale: "Any custodian with address data may use address components during parsing/normalization."
+      component_types: "street_number, route, locality, postal_code, subregion, region, country, premise, subpremise"
     comments:
     - Source-agnostic representation of address components
     - Use for parsing/normalization workflows before constructing Address objects
     - Component types follow common geographic hierarchy conventions
     - Multiple types allowed for components that serve multiple roles
+    - Intermediate representation between raw data and Address objects
     see_also:
-    - https://nde.nl/ontology/hc/classes/Address
+    - Address
     - https://www.w3.org/ns/locn#Address
-    examples:
-    - value:
-        long_name: '1'
-        short_name: '1'
-        has_type:
-        - StreetNumber
-    - value:
-        long_name: Museumstraat
-        short_name: Museumstraat
-        has_type:
-        - Route
-    - value:
-        long_name: Amsterdam
-        short_name: Amsterdam
-        has_type:
-        - Locality
-    - value:
-        long_name: Noord-Holland
-        short_name: NH
-        has_type:
-        - Region
-    - value:
-        long_name: Netherlands
-        short_name: NL
-        has_type:
-        - Country
-    - value:
-        long_name: 1071 XX
-        short_name: 1071 XX
-        has_type:
-        - PostalCode
-    annotations:
-      specificity_score: 0.35
-      specificity_rationale: Generic address parsing component. Broadly applicable
-        across all address sources and custodian types.
-      custodian_types: '["*"]'
-      custodian_types_rationale: Any custodian with address data may use address components
-        during parsing/normalization.

schemas/20251121/linkml/modules/classes/AddressType.yaml

@@ -24,16 +24,129 @@ imports:
 classes:
   AddressType:
     class_uri: skos:Concept
-    description: "Classification type for Address purposes in heritage custodian contexts.\n\n**DEFINITION**:\n\nAddressType provides a SKOS-based classification hierarchy for categorizing\ndifferent types of addresses based on their purpose or function. This enables:\n- Rich metadata (descriptions, use cases)\n- Hierarchical relationships (broader/narrower types)\n- Extensibility (new types without enum modification)\n- Semantic alignment with vCard, GLEIF, and Schema.org ontologies\n\n**ONTOLOGY ALIGNMENT**:\n\n| Ontology | Class/Property | Notes |\n|----------|----------------|-------|\n| **vCard** | `vcard:Type` | RFC6350 type codes (Home, Work) |\n| **GLEIF** | `gleif_base:hasAddressLegal`, `gleif_base:hasAddressHeadquarters` | Legal entity addresses |\n| **CIDOC-CRM** | `crm:E55_Type` | General type classification |\n| **SKOS** | `skos:Concept` | Controlled vocabulary concept |\n\n**ADDRESS TYPES FOR HERITAGE CUSTODIANS**:\n\n| Type | Use Case |\n|------|----------|\n| `HEADQUARTERS`\
+    description: >-
-      \ | Main organizational address |\n| `LEGAL` | Registered legal/business address (KvK, Chamber of Commerce) |\n| `VISITING` | Public visitor entrance address |\n| `MAILING` | Correspondence/postal address |\n| `STORAGE` | Depot, warehouse, off-site storage facility |\n| `BRANCH` | Branch office location |\n| `READING_ROOM` | Public reading/research room entrance |\n\n**RELATIONSHIP TO OTHER CLASSES**:\n\n```\nAddress (physical address)\n  \u2502\n  \u2514\u2500\u2500 has_type \u2192 AddressType (THIS CLASS)\n        \u251C\u2500\u2500 has_hypernym \u2192 AddressType (parent in hierarchy)\n        \u251C\u2500\u2500 has_hyponym \u2192 AddressType[] (children)\n        \u2514\u2500\u2500 has_description (text)\n```\n\n**SLOT MIGRATION** (2026-01-13):\n\nThis class replaces the address_type string slot with a proper class hierarchy.\nOld pattern: `address_type: HEADQUARTERS` (string)\nNew pattern: `has_type: AddressType` (object reference)\n"
+      Classification type for address purposes in heritage custodian contexts.
-    exact_mappings:
+      
-    - skos:Concept
+      SKOS-based classification hierarchy for categorizing different types of 
+      addresses based on their purpose or function. Enables rich metadata, 
+      hierarchical relationships, and semantic alignment with vCard, GLEIF, 
+      and Schema.org ontologies.
+    alt_descriptions:
+      nl:
+        text: >-
+          Classificatietype voor adresdoeleinden in erfgoedbeheerderscontext.
+          
+          SKOS-gebaseerde classificatiehiërarchie voor het categoriseren van 
+          verschillende soorten adressen op basis van hun doel of functie. 
+          Maakt rijke metadata, hiërarchische relaties en semantische afstemming 
+          met vCard, GLEIF en Schema.org ontologieën mogelijk.
+      de:
+        text: >-
+          Klassifikationstyp für Adresszwecke im Kontext von Kulturgüterverwaltern.
+          
+          SKOS-basierte Klassifikationshierarchie zur Kategorisierung verschiedener 
+          Adresstypen basierend auf ihrem Zweck oder ihrer Funktion. Ermöglicht 
+          umfangreiche Metadaten, hierarchische Beziehungen und semantische 
+          Ausrichtung mit vCard-, GLEIF- und Schema.org-Ontologien.
+      fr:
+        text: >-
+          Type de classification pour les objectifs d'adresse dans le contexte des dépositaires du patrimoine.
+          
+          Hiérarchie de classification basée sur SKOS pour catégoriser les différents 
+          types d'adresses en fonction de leur objectif ou fonction. Permet des métadonnées 
+          riches, des relations hiérarchiques et un alignement sémantique avec les ontologies 
+          vCard, GLEIF et Schema.org.
+      es:
+        text: >-
+          Tipo de clasificación para fines de dirección en el contexto de custodios del patrimonio.
+          
+          Jerarquía de clasificación basada en SKOS para categorizar diferentes tipos 
+          de direcciones según su propósito o función. Permite metadatos ricos, 
+          relaciones jerárquicas y alineación semántica con ontologías vCard, GLEIF y Schema.org.
+      ar:
+        text: >-
+          نوع التصنيف لأغراض العنوان في سياق أمناء التراث.
+          
+          تسلسل تصنيف قائم على SKOS لتصنيف أنواع مختلفة من العناوين بناءً على 
+          الغرض أو الوظيفة. يتيح بيانات وصفية غنية وعلاقات هرمية ومواءمة دلالية 
+          مع أنطولوجيات vCard وGLEIF وSchema.org.
+      id:
+        text: >-
+          Jenis klasifikasi untuk tujuan alamat dalam konteks pengelola warisan.
+          
+          Hierarki klasifikasi berbasis SKOS untuk mengkategorikan berbagai jenis 
+          alamat berdasarkan tujuan atau fungsinya. Memungkinkan metadata yang kaya, 
+          hubungan hierarkis, dan penyelarasan semantik dengan ontologi vCard, GLEIF, dan Schema.org.
+      zh:
+        text: >-
+          遗产保管人背景下地址目的的分类类型。
+          
+          基于 SKOS 的分类层次结构，用于根据目的或功能对不同类型的地址进行分类。
+          支持丰富的元数据、层次关系以及与 vCard、GLEIF 和 Schema.org 本体的语义对齐。
+    examples:
+    - value:
+        identified_by: https://nde.nl/ontology/hc/address-type/headquarters
+        has_code: HEADQUARTERS
+        has_label:
+        - Headquarters@en
+        - Hoofdkantoor@nl
+        has_description: Main organizational address where primary operations occur. This is typically where leadership and central administration are located.
+      description: Headquarters address type
+    - value:
+        identified_by: https://nde.nl/ontology/hc/address-type/legal
+        has_code: LEGAL
+        has_label:
+        - Legal Address@en
+        - Juridisch adres@nl
+        - Statutaire zetel@nl
+        has_description: Registered legal address for official correspondence and legal purposes. May differ from operational headquarters. For Dutch organizations, this is the address registered with KvK.
+      description: Legal address type
     close_mappings:
     - vcard:Type
+    broad_mappings:
+    - skos:Concept
     - crm:E55_Type
     related_mappings:
     - gleif_base:hasAddressLegal
     - gleif_base:hasAddressHeadquarters
+    structured_aliases:
+    - literal_form: adrestype
+      in_language: nl
+    - literal_form: adresclassificatie
+      in_language: nl
+    - literal_form: Adresstyp
+      in_language: de
+    - literal_form: Adressklassifikation
+      in_language: de
+    - literal_form: type d'adresse
+      in_language: fr
+    - literal_form: classification d'adresse
+      in_language: fr
+    - literal_form: tipo de dirección
+      in_language: es
+    - literal_form: clasificación de dirección
+      in_language: es
+    - literal_form: نوع العنوان
+      in_language: ar
+    - literal_form: تصنيف العنوان
+      in_language: ar
+    - literal_form: tipe alamat
+      in_language: id
+    - literal_form: klasifikasi alamat
+      in_language: id
+    - literal_form: 地址类型
+      in_language: zh
+    - literal_form: 地址分类
+      in_language: zh
+    keywords:
+    - address type
+    - headquarters
+    - legal address
+    - visiting address
+    - mailing address
+    - storage address
+    - branch address
+    - classification
     slots:
     - identified_by
     - has_code
@@ -45,17 +158,15 @@ classes:
     - equivalent_to
     slot_usage:
       identified_by:
-#         range: string # uriorcurie
         required: true
         identifier: true
-        pattern: ^https://nde\.nl/ontology/hc/address-type/[a-z0-9-]+$
+        pattern: "^https://nde\\.nl/ontology/hc/address-type/[a-z0-9-]+$"
         examples:
         - value: https://nde.nl/ontology/hc/address-type/headquarters
         - value: https://nde.nl/ontology/hc/address-type/legal
       has_code:
-#         range: string
         required: true
-        pattern: ^[A-Z][A-Z0-9_]*$
+        pattern: "^[A-Z][A-Z0-9_]*$"
         examples:
         - value: HEADQUARTERS
         - value: LEGAL
@@ -64,7 +175,6 @@ classes:
         - value: STORAGE
         - value: BRANCH
       has_label:
-#         range: string
         required: true
         multivalued: true
         examples:
@@ -78,7 +188,6 @@ classes:
           - Visiting Address@en
           - Bezoekadres@nl
       has_description:
-#         range: string
         examples:
         - value: Main organizational address where primary operations occur.
       has_hypernym:
@@ -100,70 +209,20 @@ classes:
         - value:
           - qid: Q1234567
     annotations:
-      specificity_score: '0.30'
+      specificity_score: "0.30"
-      specificity_rationale: Address types are broadly applicable - all heritage custodians have addresses.
+      specificity_rationale: "Address types are broadly applicable - all heritage custodians have addresses."
       has_score: null
-      slot_migration: "2026-01-13: Migrated from address_type string slot to AddressType class\n- address_type (string) \u2192 has_type (AddressType)\n"
+      slot_migration: "2026-01-13: Migrated from address_type string slot to AddressType class - address_type (string) → has_type (AddressType)"
       custodian_types: "['*']"
+      address_types: "HEADQUARTERS, LEGAL, VISITING, MAILING, STORAGE, BRANCH, READING_ROOM"
     comments:
     - AddressType provides SKOS-based classification for Address instances
     - Supports hierarchical type relationships (has_hypernym/hyponym)
     - Richer semantics than flat address_type string slot
     - Aligned with vCard Type, GLEIF address distinctions
-    - 'MIGRATED 2026-01-13: Now uses shared slots (Rule 38)'
+    - MIGRATED 2026-01-13: Now uses shared slots (Rule 38)
     see_also:
     - https://www.w3.org/TR/vcard-rdf/#d4e1769
     - https://www.gleif.org/ontology/Base/
-    examples:
+    - Address
-    - value:
+    - AddressTypes
-        identified_by: https://nde.nl/ontology/hc/address-type/headquarters
-        has_code: HEADQUARTERS
-        has_label:
-        - Headquarters@en
-        - Hoofdkantoor@nl
-        has_description: 'Main organizational address where primary operations occur.
-
-          This is typically where leadership and central administration
-
-          are located.
-
-          '
-    - value:
-        identified_by: https://nde.nl/ontology/hc/address-type/legal
-        has_code: LEGAL
-        has_label:
-        - Legal Address@en
-        - Juridisch adres@nl
-        - Statutaire zetel@nl
-        has_description: 'Registered legal address for official correspondence and legal
-
-          purposes. May differ from operational headquarters.
-
-          For Dutch organizations, this is the address registered with KvK.
-
-          '
-    - value:
-        identified_by: https://nde.nl/ontology/hc/address-type/visiting
-        has_code: VISITING
-        has_label:
-        - Visiting Address@en
-        - Bezoekadres@nl
-        has_description: 'Public entrance for visitors. May include museums, archives,
-
-          or libraries with public reading rooms.
-
-          '
-    - value:
-        identified_by: https://nde.nl/ontology/hc/address-type/storage
-        has_code: STORAGE
-        has_label:
-        - Storage Facility@en
-        - Opslaglocatie@nl
-        - Depot@nl
-        has_description: 'Off-site storage facility, depot, or warehouse for collections.
-
-          Not typically open to the public.
-
-          '
-        related_to:
-        - https://nde.nl/ontology/hc/address-type/branch

schemas/20251121/linkml/modules/classes/AddressTypes.yaml

@@ -15,23 +15,69 @@ classes:
   HeadquartersAddress:
     is_a: AddressType
     class_uri: hc:HeadquartersAddress
-    description: 'Main organizational headquarters address where primary operations
+    description: >-
-      occur.
+      Main organizational headquarters address where primary operations occur.
       
-      This is typically where leadership and central administration are located.
+      Typically where leadership and central administration are located.
+    alt_descriptions:
+      nl:
+        text: >-
+          Hoofdkantooradres waar de primaire operaties plaatsvinden.
           
+          Doorgaans waar het leiderschap en de centrale administratie gevestigd zijn.
+      de:
+        text: >-
+          Hauptgeschäftsadresse, an der die primären Betriebstätigkeiten stattfinden.
           
-      **Ontology Alignment**:
+          Typischerweise dort, wo die Leitung und die zentrale Verwaltung angesiedelt sind.
+      fr:
+        text: >-
+          Adresse du siège social où se déroulent les opérations principales.
           
-      - GLEIF: `gleif_base:hasAddressHeadquarters`
+          Généralement là où se trouvent la direction et l'administration centrale.
+      es:
+        text: >-
+          Dirección de la sede central donde ocurren las operaciones principales.
           
-      '
+          Típicamente donde se encuentran el liderazgo y la administración central.
+      ar:
+        text: >-
+          عنوان المقر الرئيسي حيث تتم العمليات الأساسية.
+          
+          عادة حيث يقع القيادة والإدارة المركزية.
+      id:
+        text: >-
+          Alamat kantor pusat tempat operasi utama berlangsung.
+          
+          Biasanya tempat kepemimpinan dan administrasi pusat berada.
+      zh:
+        text: >-
+          主要运营发生的主要组织总部地址。
+          
+          通常是领导层和中央行政部门所在地。
     close_mappings:
     - gleif_base:hasAddressHeadquarters
+    broad_mappings:
+    - skos:Concept
+    structured_aliases:
+    - literal_form: hoofdkantooradres
+      in_language: nl
+    - literal_form: Hauptgeschäftsadresse
+      in_language: de
+    - literal_form: adresse du siège
+      in_language: fr
+    - literal_form: dirección de la sede
+      in_language: es
+    - literal_form: عنوان المقر
+      in_language: ar
+    - literal_form: alamat kantor pusat
+      in_language: id
+    - literal_form: 总部地址
+      in_language: zh
     annotations:
       short_code: HEADQUARTERS
-      specificity_score: '0.25'
+      specificity_score: "0.25"
-      custodian_types: '[''*'']'
+      custodian_types: "['*']"
     examples:
     - value:
         has_code: HEADQUARTERS
@@ -39,31 +85,80 @@ classes:
         - Headquarters@en
         - Hoofdkantoor@nl
       description: Rijksmuseum main headquarters
-    broad_mappings:
-    - skos:Concept
   LegalAddress:
     is_a: AddressType
     class_uri: hc:LegalAddress
-    description: 'Registered legal address for official correspondence and legal purposes.
+    description: >-
+      Registered legal address for official correspondence and legal purposes.
       
-      May differ from operational headquarters.
+      May differ from operational headquarters. For Dutch organizations, 
+      this is the address registered with the Chamber of Commerce (Kamer van Koophandel - KvK).
+    alt_descriptions:
+      nl:
+        text: >-
+          Geregistreerd juridisch adres voor officiële correspondentie en juridische doeleinden.
           
+          Kan afwijken van het operationele hoofdkantoor. Voor Nederlandse organisaties 
+          is dit het adres dat bij de KvK geregistreerd staat.
+      de:
+        text: >-
+          Eingetragene Rechtsadresse für offizielle Korrespondenz und rechtliche Zwecke.
           
-      For Dutch organizations, this is the address registered with the
+          Kann vom operativen Hauptsitz abweichen. Für niederländische Organisationen 
+          ist dies die bei der Handelskammer registrierte Adresse.
+      fr:
+        text: >-
+          Adresse légale enregistrée pour la correspondance officielle et les objectifs juridiques.
           
-      Chamber of Commerce (Kamer van Koophandel - KvK).
+          Peut différer du siège opérationnel. Pour les organisations néerlandaises, 
+          c'est l'adresse enregistrée auprès de la Chambre de Commerce.
+      es:
+        text: >-
+          Dirección legal registrada para correspondencia oficial y fines legales.
           
+          Puede diferir de la sede operativa. Para organizaciones holandesas, 
+          esta es la dirección registrada en la Cámara de Comercio.
+      ar:
+        text: >-
+          العنوان القانوني المسجل للمراسلات الرسمية والأغراض القانونية.
           
-      **Ontology Alignment**:
+          قد يختلف عن المقر التشغيلي. بالنسبة للمنظمات الهولندية، 
+          هذا هو العنوان المسجل في غرفة التجارة.
+      id:
+        text: >-
+          Alamat legal terdaftar untuk korespondensi resmi dan tujuan hukum.
           
-      - GLEIF: `gleif_base:hasAddressLegal`
+          Mungkin berbeda dari kantor pusat operasional. Untuk organisasi Belanda, 
+          ini adalah alamat yang terdaftar di Kamar Dagang.
+      zh:
+        text: >-
+          用于正式通信和法律目的的注册法定地址。
           
-      '
+          可能与运营总部不同。对于荷兰组织，这是在商会注册的地址。
     close_mappings:
     - gleif_base:hasAddressLegal
+    broad_mappings:
+    - skos:Concept
+    structured_aliases:
+    - literal_form: juridisch adres
+      in_language: nl
+    - literal_form: statutaire zetel
+      in_language: nl
+    - literal_form: Rechtsadresse
+      in_language: de
+    - literal_form: adresse légale
+      in_language: fr
+    - literal_form: dirección legal
+      in_language: es
+    - literal_form: عنوان قانوني
+      in_language: ar
+    - literal_form: alamat legal
+      in_language: id
+    - literal_form: 法定地址
+      in_language: zh
     annotations:
       short_code: LEGAL
-      specificity_score: '0.30'
+      specificity_score: "0.30"
     examples:
     - value:
         has_code: LEGAL
@@ -72,24 +167,77 @@ classes:
         - Juridisch adres@nl
         - Statutaire zetel@nl
       description: Registered legal address from KvK
-    broad_mappings:
-    - skos:Concept
   VisitingAddress:
     is_a: AddressType
     class_uri: hc:VisitingAddress
-    description: 'Public entrance address for visitors.
+    description: >-
-
+      Public entrance address for visitors.
       
       For heritage custodians, this is typically where the public enters 
-
       to visit exhibitions, reading rooms, or public services. 
-
       May include accessible entrances for persons with disabilities.
+    alt_descriptions:
+      nl:
+        text: >-
+          Openbare ingang voor bezoekers.
           
-      '
+          Voor erfgoedbeheerders is dit doorgaans waar het publiek binnenkomt 
+          om tentoonstellingen, leeszalen of openbare diensten te bezoeken.
+      de:
+        text: >-
+          Öffentliche Eingangsadresse für Besucher.
+          
+          Für Kulturgüterverwalter ist dies typischerweise der Eingang für die Öffentlichkeit 
+          zu Ausstellungen, Lesesälen oder öffentlichen Diensten.
+      fr:
+        text: >-
+          Adresse d'entrée publique pour les visiteurs.
+          
+          Pour les dépositaires du patrimoine, c'est généralement là que le public 
+          entre pour visiter les expositions, les salles de lecture ou les services publics.
+      es:
+        text: >-
+          Dirección de entrada pública para visitantes.
+          
+          Para custodios del patrimonio, este es típicamente donde el público 
+          entra para visitar exposiciones, salas de lectura o servicios públicos.
+      ar:
+        text: >-
+          عنوان المدخل العام للزوار.
+          
+          لأمناء التراث، هذا عادة حيث يدخل الجمهور لزيارة المعارض 
+          أو غرف القراءة أو الخدمات العامة.
+      id:
+        text: >-
+          Alamat masuk publik untuk pengunjung.
+          
+          Untuk pengelola warisan, ini biasanya tempat publik masuk 
+          untuk mengunjungi pameran, ruang baca, atau layanan publik.
+      zh:
+        text: >-
+          访客公共入口地址。
+          
+          对于遗产保管人，这通常是公众进入参观展览、阅览室或公共服务的地方。
+    broad_mappings:
+    - skos:Concept
+    structured_aliases:
+    - literal_form: bezoekadres
+      in_language: nl
+    - literal_form: Besucheradresse
+      in_language: de
+    - literal_form: adresse de visite
+      in_language: fr
+    - literal_form: dirección de visita
+      in_language: es
+    - literal_form: عنوان الزيارة
+      in_language: ar
+    - literal_form: alamat kunjungan
+      in_language: id
+    - literal_form: 访客地址
+      in_language: zh
     annotations:
       short_code: VISITING
-      specificity_score: '0.25'
+      specificity_score: "0.25"
     examples:
     - value:
         has_code: VISITING
@@ -97,22 +245,78 @@ classes:
         - Visiting Address@en
         - Bezoekadres@nl
       description: Public visitor entrance
-    broad_mappings:
-    - skos:Concept
   MailingAddress:
     is_a: AddressType
     class_uri: hc:MailingAddress
-    description: 'Postal correspondence address.
+    description: >-
-
+      Postal correspondence address.
       
       Address for receiving mail and correspondence. May be a P.O. Box 
-
       or differ from physical location addresses.
+    alt_descriptions:
+      nl:
+        text: >-
+          Postcorrespondentieadres.
           
-      '
+          Adres voor het ontvangen van post en correspondentie. 
+          Kan een postbus zijn of afwijken van fysieke locatieadressen.
+      de:
+        text: >-
+          Postanschrift.
+          
+          Adresse für den Empfang von Post und Korrespondenz. 
+          Kann ein Postfach sein oder von physischen Standortadressen abweichen.
+      fr:
+        text: >-
+          Adresse postale.
+          
+          Adresse pour recevoir le courrier et la correspondance. 
+          Peut être une boîte postale ou différer des adresses physiques.
+      es:
+        text: >-
+          Dirección postal.
+          
+          Dirección para recibir correo y correspondencia. 
+          Puede ser un apartado postal o diferir de las direcciones físicas.
+      ar:
+        text: >-
+          عنوان المراسلات البريدية.
+          
+          عنوان لتلقي البريد والمراسلات. 
+          قد يكون صندوق بريد أو يختلف عن عناوين المواقع الفعلية.
+      id:
+        text: >-
+          Alamat korespondensi pos.
+          
+          Alamat untuk menerima surat dan korespondensi. 
+          Mungkin berupa kotak pos atau berbeda dari alamat fisik.
+      zh:
+        text: >-
+          邮政通信地址。
+          
+          接收邮件和通信的地址。可能是邮政信箱或与实际地点地址不同。
+    broad_mappings:
+    - skos:Concept
+    structured_aliases:
+    - literal_form: postadres
+      in_language: nl
+    - literal_form: correspondentieadres
+      in_language: nl
+    - literal_form: Postadresse
+      in_language: de
+    - literal_form: adresse postale
+      in_language: fr
+    - literal_form: dirección postal
+      in_language: es
+    - literal_form: عنوان بريدي
+      in_language: ar
+    - literal_form: alamat pos
+      in_language: id
+    - literal_form: 邮寄地址
+      in_language: zh
     annotations:
       short_code: MAILING
-      specificity_score: '0.25'
+      specificity_score: "0.25"
     examples:
     - value:
         has_code: MAILING
@@ -121,27 +325,78 @@ classes:
         - Postadres@nl
         - Correspondentieadres@nl
       description: Postal correspondence address
-    broad_mappings:
-    - skos:Concept
   StorageAddress:
     is_a: AddressType
     class_uri: hc:StorageAddress
-    description: 'Off-site storage facility, depot, or warehouse address.
+    description: >-
-
+      Off-site storage facility, depot, or warehouse address.
       
       Not typically open to the public. May house collection items 
+      not currently on display, archival materials, or preservation facilities.
+    alt_descriptions:
+      nl:
+        text: >-
+          Adres van externe opslagfaciliteit, depot of magazijn.
           
-      not currently on display, archival materials, or preservation
+          Doorgaans niet openbaar. Kan collectiestukken herbergen die 
+          momenteel niet tentoongesteld worden, archiefmaterialen of conserveringsfaciliteiten.
+      de:
+        text: >-
+          Adresse einer externen Lagereinrichtung, Depots oder Lagers.
           
-      facilities.
+          Normalerweise nicht öffentlich zugänglich. Kann Sammlungsstücke beherbergen, 
+          die derzeit nicht ausgestellt sind, Archivmaterialien oder Konservierungseinrichtungen.
+      fr:
+        text: >-
+          Adresse d'une installation de stockage externe, dépôt ou entrepôt.
           
+          Généralement pas ouvert au public. Peut abriter des pièces de collection 
+          non exposées, des documents d'archives ou des installations de conservation.
+      es:
+        text: >-
+          Dirección de instalación de almacenamiento externo, depósito o almacén.
           
-      Related to StorageType for describing the type of storage facility.
+          Normalmente no abierto al público. Puede albergar piezas de colección 
+          no expuestas, materiales de archivo o instalaciones de conservación.
+      ar:
+        text: >-
+          عنوان منشأة التخزين الخارجية أو المستودع أو المخزن.
           
-      '
+          عادة غير مفتوح للجمهور. قد يحتوي على قطع المجموعة غير المعروضة 
+          أو المواد الأرشيفية أو مرافق الحفظ.
+      id:
+        text: >-
+          Alamat fasilitas penyimpanan luar lokasi, depot, atau gudang.
+          
+          Biasanya tidak terbuka untuk umum. Dapat menampung koleksi yang 
+          tidak dipamerkan, materi arsip, atau fasilitas konservasi.
+      zh:
+        text: >-
+          场外存储设施、仓库或库房地址。
+          
+          通常不向公众开放。可能存放当前未展出的藏品、档案材料或保护设施。
+    broad_mappings:
+    - skos:Concept
+    structured_aliases:
+    - literal_form: opslaglocatie
+      in_language: nl
+    - literal_form: depot
+      in_language: nl
+    - literal_form: Lageradresse
+      in_language: de
+    - literal_form: adresse de dépôt
+      in_language: fr
+    - literal_form: dirección de almacenamiento
+      in_language: es
+    - literal_form: عنوان التخزين
+      in_language: ar
+    - literal_form: alamat penyimpanan
+      in_language: id
+    - literal_form: 存储地址
+      in_language: zh
     annotations:
       short_code: STORAGE
-      specificity_score: '0.40'
+      specificity_score: "0.40"
     examples:
     - value:
         has_code: STORAGE
@@ -150,24 +405,78 @@ classes:
         - Opslaglocatie@nl
         - Depot@nl
       description: Off-site collection depot
-    broad_mappings:
-    - skos:Concept
   BranchAddress:
     is_a: AddressType
     class_uri: hc:BranchAddress
-    description: 'Branch office or satellite location address.
+    description: >-
-
+      Branch office or satellite location address.
       
       For heritage custodians with multiple locations, this identifies 
+      addresses of branch offices, satellite reading rooms, or regional service points.
+    alt_descriptions:
+      nl:
+        text: >-
+          Adres van bijkantoor of satellietlocatie.
           
-      addresses of branch offices, satellite reading rooms, or regional
+          Voor erfgoedbeheerders met meerdere locaties identificeert dit 
+          adressen van bijkantoren, satelliet-leeszalen of regionale servicepunten.
+      de:
+        text: >-
+          Adresse einer Zweigstelle oder Satellitenstandort.
           
-      service points.
+          Für Kulturgüterverwalter mit mehreren Standorten identifiziert dies 
+          Adressen von Zweigstellen, Satelliten-Lesesaälen oder regionalen Dienstleistungspunkten.
+      fr:
+        text: >-
+          Adresse d'une succursale ou d'un site satellite.
           
-      '
+          Pour les dépositaires du patrimoine avec plusieurs sites, cela identifie 
+          les adresses des succursales, des salles de lecture satellites ou des points de service régionaux.
+      es:
+        text: >-
+          Dirección de oficina sucursal o ubicación satelital.
+          
+          Para custodios del patrimonio con múltiples ubicaciones, esto identifica 
+          direcciones de sucursales, salas de lectura satelitales o puntos de servicio regionales.
+      ar:
+        text: >-
+          عنوان الفرع أو الموقع التابع.
+          
+          لأمناء التراث ذوي المواقع المتعددة، يحدد هذا عناوين الفروع 
+          أو غرف القراءة التابعة أو نقاط الخدمة الإقليمية.
+      id:
+        text: >-
+          Alamat kantor cabang atau lokasi satelit.
+          
+          Untuk pengelola warisan dengan beberapa lokasi, ini mengidentifikasi 
+          alamat kantor cabang, ruang baca satelit, atau titik layanan regional.
+      zh:
+        text: >-
+          分支机构或卫星地点地址。
+          
+          对于有多个地点的遗产保管人，这标识分支机构、卫星阅览室或区域服务点的地址。
+    broad_mappings:
+    - skos:Concept
+    structured_aliases:
+    - literal_form: vestiging
+      in_language: nl
+    - literal_form: filiaal
+      in_language: nl
+    - literal_form: Zweigstellenadresse
+      in_language: de
+    - literal_form: adresse de succursale
+      in_language: fr
+    - literal_form: dirección de sucursal
+      in_language: es
+    - literal_form: عنوان الفرع
+      in_language: ar
+    - literal_form: alamat cabang
+      in_language: id
+    - literal_form: 分支地址
+      in_language: zh
     annotations:
       short_code: BRANCH
-      specificity_score: '0.35'
+      specificity_score: "0.35"
     examples:
     - value:
         has_code: BRANCH
@@ -176,24 +485,85 @@ classes:
         - Vestiging@nl
         - Filiaal@nl
       description: Branch office location
-    broad_mappings:
-    - skos:Concept
   ReadingRoomAddress:
     is_a: AddressType
     class_uri: hc:ReadingRoomAddress
-    description: 'Public reading room or research room entrance address.
+    description: >-
-
+      Public reading room or research room entrance address.
       
       Specific to archives and libraries, this identifies where 
-
       researchers access original materials for consultation. 
-
       May differ from the main visiting address.
+    alt_descriptions:
+      nl:
+        text: >-
+          Openbare leeszaal of onderzoekskamer ingang.
           
-      '
+          Specifiek voor archieven en bibliotheken, identificeert dit waar 
+          onderzoekers origineel materiaal raadplegen. 
+          Kan afwijken van het hoofdbezoekadres.
+      de:
+        text: >-
+          Öffentlicher Lesesaal oder Forschungsraum Eingangsadresse.
+          
+          Spezifisch für Archive und Bibliotheken, identifiziert dies, wo 
+          Forscher Originalmaterialien konsultieren. 
+          Kann von der Hauptbesucheradresse abweichen.
+      fr:
+        text: >-
+          Adresse d'entrée de la salle de lecture ou de la salle de recherche publique.
+          
+          Spécifique aux archives et bibliothèques, cela identifie l'endroit 
+          où les chercheurs consultent les documents originaux. 
+          Peut différer de l'adresse de visite principale.
+      es:
+        text: >-
+          Dirección de entrada a sala de lectura o sala de investigación pública.
+          
+          Específico para archivos y bibliotecas, esto identifica dónde 
+          los investigadores acceden a materiales originales para consulta. 
+          Puede diferir de la dirección de visita principal.
+      ar:
+        text: >-
+          عنوان مدخل غرفة القراءة أو غرفة البحث العامة.
+          
+          خاص بالأرشيف والمكتبات، يحدد هذا المكان الذي يصل فيه الباحثون 
+          إلى المواد الأصلية للاستشارة. قد يختلف عن عنوان الزيارة الرئيسي.
+      id:
+        text: >-
+          Alamat masuk ruang baca atau ruang penelitian publik.
+          
+          Khusus untuk arsip dan perpustakaan, ini mengidentifikasi tempat 
+          peneliti mengakses materi asli untuk konsultasi. 
+          Mungkin berbeda dari alamat kunjungan utama.
+      zh:
+        text: >-
+          公共阅览室或研究室入口地址。
+          
+          专门针对档案馆和图书馆，标识研究人员查阅原始材料的地方。
+          可能与主要访客地址不同。
+    broad_mappings:
+    - skos:Concept
+    structured_aliases:
+    - literal_form: studiezaal
+      in_language: nl
+    - literal_form: leeszaal
+      in_language: nl
+    - literal_form: Leseadresse
+      in_language: de
+    - literal_form: adresse de salle de lecture
+      in_language: fr
+    - literal_form: dirección de sala de lectura
+      in_language: es
+    - literal_form: عنوان غرفة القراءة
+      in_language: ar
+    - literal_form: alamat ruang baca
+      in_language: id
+    - literal_form: 阅览室地址
+      in_language: zh
     annotations:
       short_code: READING_ROOM
-      specificity_score: '0.50'
+      specificity_score: "0.50"
     examples:
     - value:
         has_code: READING_ROOM
@@ -202,22 +572,78 @@ classes:
         - Studiezaal@nl
         - Leeszaal@nl
       description: Archive/library reading room entrance
-    broad_mappings:
-    - skos:Concept
   DeliveryAddress:
     is_a: AddressType
     class_uri: hc:DeliveryAddress
-    description: 'Goods delivery and receiving address.
+    description: >-
-
+      Goods delivery and receiving address.
       
       Address for receiving deliveries, including acquisitions, 
-
       loans, and supplies. May include loading dock facilities.
+    alt_descriptions:
+      nl:
+        text: >-
+          Goederenlevering en ontvangstadres.
           
-      '
+          Adres voor het ontvangen van leveringen, inclusief acquisities, 
+          leningen en benodigdheden. Kan laadfaciliteiten omvatten.
+      de:
+        text: >-
+          Warenlieferungs- und Empfangsadresse.
+          
+          Adresse für den Empfang von Lieferungen, einschließlich Erwerbungen, 
+          Leihgaben und Vorräten. Kann Ladevorrichtungen umfassen.
+      fr:
+        text: >-
+          Adresse de livraison et de réception de marchandises.
+          
+          Adresse pour recevoir les livraisons, y compris les acquisitions, 
+          les prêts et les fournitures. Peut inclure des installations de quai de chargement.
+      es:
+        text: >-
+          Dirección de entrega y recepción de mercancías.
+          
+          Dirección para recibir entregas, incluidas adquisiciones, 
+          préstamos y suministros. Puede incluir instalaciones de muelle de carga.
+      ar:
+        text: >-
+          عنوان تسليم واستلام البضائع.
+          
+          عنوان لتلقي التسليمات، بما في ذلك عمليات الاستحواذ 
+          والقروض والإمدادات. قد يشمل مرافق رصيف التحميل.
+      id:
+        text: >-
+          Alamat pengiriman dan penerimaan barang.
+          
+          Alamat untuk menerima pengiriman, termasuk akuisisi, 
+          pinjaman, dan perlengkapan. Dapat mencakup fasilitas dermaga muat.
+      zh:
+        text: >-
+          货物交付和接收地址。
+          
+          接收交付的地址，包括收购、借展和供应品。可能包括装卸码头设施。
+    broad_mappings:
+    - skos:Concept
+    structured_aliases:
+    - literal_form: afleveradres
+      in_language: nl
+    - literal_form: goederenontvangst
+      in_language: nl
+    - literal_form: Lieferadresse
+      in_language: de
+    - literal_form: adresse de livraison
+      in_language: fr
+    - literal_form: dirección de entrega
+      in_language: es
+    - literal_form: عنوان التسليم
+      in_language: ar
+    - literal_form: alamat pengiriman
+      in_language: id
+    - literal_form: 交付地址
+      in_language: zh
     annotations:
       short_code: DELIVERY
-      specificity_score: '0.40'
+      specificity_score: "0.40"
     examples:
     - value:
         has_code: DELIVERY
@@ -226,22 +652,78 @@ classes:
         - Afleveradres@nl
         - Goederenontvangst@nl
       description: Delivery receiving dock
-    broad_mappings:
-    - skos:Concept
   ConservationLabAddress:
     is_a: AddressType
     class_uri: hc:ConservationLabAddress
-    description: 'Conservation laboratory or restoration facility address.
+    description: >-
-
+      Conservation laboratory or restoration facility address.
       
       May be separate from main facilities, housing specialized 
-
       equipment for preservation and restoration work.
+    alt_descriptions:
+      nl:
+        text: >-
+          Conserveringslaboratorium of restauratiefaciliteit adres.
           
-      '
+          Kan gescheiden zijn van de hoofdvestiging en gespecialiseerde 
+          apparatuur herbergen voor behoud- en restauratiewerk.
+      de:
+        text: >-
+          Adresse des Konservierungslabors oder der Restaurierungseinrichtung.
+          
+          Kann von den Haupteinrichtungen getrennt sein und beherbergt 
+          spezialisierte Ausrüstung für Erhaltungs- und Restaurierungsarbeiten.
+      fr:
+        text: >-
+          Adresse du laboratoire de conservation ou de l'installation de restauration.
+          
+          Peut être séparée des installations principales et abrite 
+          des équipements spécialisés pour les travaux de préservation et de restauration.
+      es:
+        text: >-
+          Dirección del laboratorio de conservación o instalación de restauración.
+          
+          Puede estar separada de las instalaciones principales y albergar 
+          equipos especializados para trabajos de preservación y restauración.
+      ar:
+        text: >-
+          عنوان مختبر الحفظ أو منشأة الترميم.
+          
+          قد تكون منفصلة عن المرافق الرئيسية وتضم معدات متخصصة 
+          لأعمال الحفظ والترميم.
+      id:
+        text: >-
+          Alamat laboratorium konservasi atau fasilitas restorasi.
+          
+          Mungkin terpisah dari fasilitas utama dan menampung 
+          peralatan khusus untuk pekerjaan pelestarian dan restorasi.
+      zh:
+        text: >-
+          保护实验室或修复设施地址。
+          
+          可能与主要设施分开，容纳用于保存和修复工作的专业设备。
+    broad_mappings:
+    - skos:Concept
+    structured_aliases:
+    - literal_form: restauratieatelier
+      in_language: nl
+    - literal_form: conserveringslab
+      in_language: nl
+    - literal_form: Konservierungslabor-Adresse
+      in_language: de
+    - literal_form: adresse de laboratoire de conservation
+      in_language: fr
+    - literal_form: dirección de laboratorio de conservación
+      in_language: es
+    - literal_form: عنوان مختبر الحفظ
+      in_language: ar
+    - literal_form: alamat lab konservasi
+      in_language: id
+    - literal_form: 保护实验室地址
+      in_language: zh
     annotations:
       short_code: CONSERVATION_LAB
-      specificity_score: '0.55'
+      specificity_score: "0.55"
     examples:
     - value:
         has_code: CONSERVATION_LAB
@@ -250,5 +732,3 @@ classes:
         - Restauratieatelier@nl
         - Conserveringslab@nl
       description: Restoration workshop facility
-    broad_mappings:
-    - skos:Concept

schemas/20251121/linkml/modules/classes/Administration.yaml

@@ -1,12 +1,14 @@
 id: https://nde.nl/ontology/hc/class/Administration
 name: Administration
 title: Administration
-description: An administrative unit or body.
 prefixes:
   linkml: https://w3id.org/linkml/
+  hc: https://nde.nl/ontology/hc/
   schema: http://schema.org/
   skos: http://www.w3.org/2004/02/skos/core#
   rico: https://www.ica.org/standards/RiC/ontology#
+  org: http://www.w3.org/ns/org#
+  cpov: http://data.europa.eu/m8g/
   wd: http://www.wikidata.org/entity/
 imports:
   - linkml:types
@@ -16,15 +18,132 @@ imports:
 classes:
   Administration:
     class_uri: org:OrganizationalUnit
+    description: >-
+      Administrative unit or body within a heritage custodian organization.
+      
+      Represents a distinct administrative division, department, or governance 
+      body responsible for specific organizational functions such as finance, 
+      human resources, governance, or institutional policy.
+    alt_descriptions:
+      nl:
+        text: >-
+          Administratieve eenheid of orgaan binnen een erfgoedbeheerderorganisatie.
+          
+          Vertegenwoordigt een aparte administratieve afdeling, departement of 
+          bestuursorgaan dat verantwoordelijk is voor specifieke organisatorische functies 
+          zoals financiën, human resources, bestuur of institutioneel beleid.
+      de:
+        text: >-
+          Verwaltungseinheit oder Gremium innerhalb einer Kulturgüterverwalterorganisation.
+          
+          Repräsentiert eine eigenständige Verwaltungseinheit, Abteilung oder 
+          ein Leitungsorgan, das für spezifische organisatorische Funktionen 
+          wie Finanzen, Personalwesen, Governance oder institutionspolitische Angelegenheiten verantwortlich ist.
+      fr:
+        text: >-
+          Unité administrative ou organe au sein d'une organisation de dépositaire du patrimoine.
+          
+          Représente une division administrative distincte, un département ou 
+          un organe de gouvernance responsable de fonctions organisationnelles spécifiques 
+          telles que la finance, les ressources humaines, la gouvernance ou la politique institutionnelle.
+      es:
+        text: >-
+          Unidad administrativa u órgano dentro de una organización de custodio del patrimonio.
+          
+          Representa una división administrativa distinta, departamento u 
+          órgano de gobierno responsable de funciones organizativas específicas 
+          como finanzas, recursos humanos, gobernanza o política institucional.
+      ar:
+        text: >-
+          وحدة إدارية أو هيئة داخل منظمة أمين التراث.
+          
+          تمثل قسمًا إداريًا متميزًا أو إدارة أو هيئة حوكمة مسؤولة عن وظائف تنظيمية محددة 
+          مثل التمويل والموارد البشرية والحوكمة أو السياسة المؤسسية.
+      id:
+        text: >-
+          Unit administratif atau badan dalam organisasi pengelola warisan.
+          
+          Mewakili divisi administratif, departemen, atau badan pemerintahan 
+          yang bertanggung jawab untuk fungsi organisasi tertentu seperti 
+          keuangan, SDM, tata kelola, atau kebijakan institusional.
+      zh:
+        text: >-
+          遗产保管人组织内的行政单位或机构。
+          
+          代表负责特定组织职能（如财务、人力资源、治理或机构政策）的
+          独立行政部门、部门或管理机构。
+    examples:
+    - value:
+        has_label: Finance Department
+        has_description: Responsible for budget management, accounting, and financial reporting
+      description: Administrative finance department
     close_mappings:
-      - rico:CorporateBody
+    - rico:CorporateBody
-      - cpov:PublicOrganisation
+    - cpov:PublicOrganisation
-    description: An administrative unit or body.
+    - schema:Organization
+    structured_aliases:
+    - literal_form: administratie
+      in_language: nl
+    - literal_form: bestuur
+      in_language: nl
+    - literal_form: Verwaltung
+      in_language: de
+    - literal_form: Verwaltungseinheit
+      in_language: de
+    - literal_form: administration
+      in_language: fr
+    - literal_form: organe administratif
+      in_language: fr
+    - literal_form: administración
+      in_language: es
+    - literal_form: órgano administrativo
+      in_language: es
+    - literal_form: إدارة
+      in_language: ar
+    - literal_form: هيئة إدارية
+      in_language: ar
+    - literal_form: administrasi
+      in_language: id
+    - literal_form: badan administratif
+      in_language: id
+    - literal_form: 行政
+      in_language: zh
+    - literal_form: 管理部门
+      in_language: zh
+    keywords:
+    - administration
+    - administrative unit
+    - department
+    - governance
+    - management
+    - organizational unit
     slots:
     - has_label
     - has_description
     - identified_by
+    slot_usage:
+      has_label:
+        required: true
+        examples:
+        - value: Finance Department
+        - value: Board of Directors
+      has_description:
+        required: false
+        examples:
+        - value: Responsible for budget management, accounting, and financial reporting
+      identified_by:
+        required: false
+        examples:
+        - value: https://nde.nl/ontology/hc/administration/finance-dept
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.10"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: "Generic utility class - administrative units are broadly applicable across all organizational contexts."
       custodian_types: "['*']"
+    comments:
+    - Represents internal administrative divisions within heritage custodians
+    - May include departments, committees, boards, or governance bodies
+    - Distinguished from external organizational relationships
+    see_also:
+    - https://www.w3.org/TR/vocab-org/#org:OrganizationalUnit
+    - AdministrativeOffice
+    - AdministrativeUnit

schemas/20251121/linkml/modules/classes/AdministrativeLevel.yaml

@@ -21,25 +21,106 @@ imports:
 classes:
   AdministrativeLevel:
     class_uri: skos:Concept
-    description: 'A level or tier within an administrative or government hierarchy.
+    description: >-
+      Level or tier within an administrative or government hierarchy.
       
+      Represents the hierarchical position of an administrative unit within 
+      a governance structure, from national/federal down to municipal/local levels.
+    alt_descriptions:
+      nl:
+        text: >-
+          Niveau of laag binnen een administratieve of overheidshiërarchie.
           
-      **Examples**:
+          Vertegenwoordigt de hiërarchische positie van een administratieve eenheid 
+          binnen een bestuursstructuur, van nationaal/federaal tot gemeentelijk/lokaal.
+      de:
+        text: >-
+          Ebene oder Stufe innerhalb einer Verwaltungs- oder Regierungshierarchie.
           
-      - National/Federal
+          Repräsentiert die hierarchische Position einer Verwaltungseinheit innerhalb 
+          einer Regierungsstruktur, von national/bundesweit bis kommunal/lokal.
+      fr:
+        text: >-
+          Niveau ou échelon dans une hiérarchie administrative ou gouvernementale.
           
-      - State/Provincial
+          Représente la position hiérarchique d'une unité administrative dans 
+          une structure de gouvernance, du niveau national/fédéral au niveau municipal/local.
+      es:
+        text: >-
+          Nivel o escalón dentro de una jerarquía administrativa o gubernamental.
           
-      - Regional
+          Representa la posición jerárquica de una unidad administrativa dentro 
+          de una estructura de gobernanza, desde nacional/federal hasta municipal/local.
+      ar:
+        text: >-
+          مستوى أو طبقة ضمن التسلسل الإداري أو الحكومي.
           
-      - Municipal/Local
+          يمثل الموقع الهرمي لوحدة إدارية داخل هيكل الحوكمة، 
+          من المستوى الوطني/الفيدرالي إلى المستوى البلدي/المحلي.
+      id:
+        text: >-
+          Tingkat atau jenjang dalam hierarki administratif atau pemerintahan.
           
+          Mewakili posisi hierarkis unit administratif dalam struktur tata kelola, 
+          dari nasional/federal hingga kotamadya/lokal.
+      zh:
+        text: >-
+          行政或政府层级中的级别或层次。
           
-      **Ontological Alignment**:
+          代表行政单位在治理结构中的层级位置，从国家/联邦到市/地方级别。
-
+    examples:
-      - `skos:Concept`: Concept in a hierarchy scheme.
+    - value:
-
+        has_label: National
-      '
+        has_code: NATIONAL
+        has_description: Highest level of government administration for a sovereign state
+      description: National/federal administrative level
+    - value:
+        has_label: Municipal
+        has_code: MUNICIPAL
+        has_description: Local government administration for a city, town, or municipality
+      description: Municipal/local administrative level
+    broad_mappings:
+    - skos:Concept
+    - crm:E55_Type
+    structured_aliases:
+    - literal_form: administratief niveau
+      in_language: nl
+    - literal_form: bestuurlijk niveau
+      in_language: nl
+    - literal_form: Verwaltungsebene
+      in_language: de
+    - literal_form: Verwaltungsstufe
+      in_language: de
+    - literal_form: niveau administratif
+      in_language: fr
+    - literal_form: échelon administratif
+      in_language: fr
+    - literal_form: nivel administrativo
+      in_language: es
+    - literal_form: escalón administrativo
+      in_language: es
+    - literal_form: المستوى الإداري
+      in_language: ar
+    - literal_form: الدرجة الإدارية
+      in_language: ar
+    - literal_form: tingkat administratif
+      in_language: id
+    - literal_form: jenjang administratif
+      in_language: id
+    - literal_form: 行政级别
+      in_language: zh
+    - literal_form: 行政层次
+      in_language: zh
+    keywords:
+    - administrative level
+    - government level
+    - federal
+    - state
+    - provincial
+    - regional
+    - municipal
+    - local
+    - hierarchy
     slots:
     - has_label
     - has_code
@@ -47,9 +128,35 @@ classes:
     slot_usage:
       has_label:
         required: true
+        examples:
+        - value: National
+        - value: State
+        - value: Provincial
+        - value: Regional
+        - value: Municipal
+        - value: Local
       has_code:
         required: false
+        examples:
+        - value: NATIONAL
+        - value: STATE
+        - value: PROVINCIAL
+        - value: REGIONAL
+        - value: MUNICIPAL
+        - value: LOCAL
+      has_description:
+        required: false
+        examples:
+        - value: Highest level of government administration for a sovereign state
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.10"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: "Generic utility class - administrative levels are broadly applicable across all governance contexts."
       custodian_types: "['*']"
+      standard_levels: "National, State/Provincial, Regional, Municipal/Local"
+    comments:
+    - Represents hierarchical position in governance structures
+    - Standard levels: National, State/Provincial, Regional, Municipal/Local
+    - Used for classifying the scope of administrative authority
+    see_also:
+    - AdministrativeUnit
+    - Administration

schemas/20251121/linkml/modules/classes/AdministrativeOffice.yaml

@@ -27,92 +27,65 @@ classes:
   AdministrativeOffice:
     is_a: ReconstructedEntity
     class_uri: org:Site
-    description: "Non-public administrative building or office space of a heritage custodian.\n**DEFINITION**:\nAn AdministrativeOffice is a secondary physical location where a heritage custodian performs back-office, administrative, or support functions that do not directly serve the public. These locations typically house staff performing finance, HR, IT, management, or other operational activities.\n**W3C ORG ALIGNMENT**:\n`org:Site` - \"An office or other premise at which the organization is located.\"\nAdministrativeOffice specializes org:Site for non-public administrative spaces: - Financial/accounting departments - Human resources offices - IT infrastructure locations - Executive/management offices\n**DISTINCTION FROM OTHER AUXILIARY PLACE TYPES**:\n| Type | Public Access | Primary Function | |------|---------------|------------------| | BranchOffice | Yes | Public service delivery | | **AdministrativeOffice** | No | Back-office operations | | ResearchCenter | Limited | Research/conservation\
+    description: >-
-      \ | | Storage | No | Collection storage |\n**TYPICAL CHARACTERISTICS**:\n- **Staff-only access**: No public visitors - **Administrative functions**: Finance, HR, IT, management - **Separate from collections**: No collection materials stored - **Cost center**: Often in lower-cost location than main building\n**USE CASES**:\n1. **Separate Administrative Building**:\n   - Museum finance department in office park\n   - Archive IT/digitization support center\n\n2. **Executive Offices**:\n   - Foundation board meeting space\n   - Director's office separate from main building\n\n3. **Support Services**:\n   - Facilities management office\n   - Marketing/communications department\n\n**Example - Administrative Annex**: ```yaml AdministrativeOffice:\n  has_admin_office_identifier: \"https://nde.nl/ontology/hc/aux/rijksmuseum-admin-zuidas\"\n  has_admin_office_name: \"Rijksmuseum Administrative Offices - Zuidas\"\n  has_admin_office_description: |\n    Administrative support offices housing finance,\
+      Non-public administrative building or office space of a heritage custodian.
-      \ HR, and IT departments.\n    Staff access only. Located in Zuidas business district for cost efficiency.\n  has_function:\n    - function_category: ADMINISTRATIVE\n      function_name: \"Finance and accounting\"\n    - function_category: ADMINISTRATIVE\n      function_name: \"Human resources\"\n    - function_category: SUPPORT\n      function_name: \"Information technology\"\n    - function_category: ADMINISTRATIVE\n      function_name: \"Legal affairs\"\n  has_access_restriction: \"Staff badge required\"\n```"
+      
-    exact_mappings:
+      Secondary physical location where back-office, administrative, or support 
-    - org:Site
+      functions are performed that do not directly serve the public. Typically 
-    close_mappings:
+      houses staff performing finance, HR, IT, management, or other operational activities.
-    - schema:Place
+    alt_descriptions:
-    - crm:E27_Site
+      nl:
-    related_mappings:
+        text: >-
-    - schema:Corporation
+          Niet-openbaar administratief gebouw of kantoorruimte van een erfgoedbeheerder.
-    - org:OrganizationalUnit
+          
-    slots:
+          Secundaire fysieke locatie waar back-office, administratieve of ondersteunende 
-    - has_description
+          functies worden uitgevoerd die het publiek niet direct bedienen. Doorgaans 
-    - identified_by
+          gehuisvest door personeel dat zich bezighoudt met financiën, HR, IT, management 
-    - has_label
+          of andere operationele activiteiten.
-    # has_admin_staff_count REMOVED - migrated to has_staff_member (Rule 53)
+      de:
-    - has_staff
+        text: >-
-    - has_function
+          Nicht-öffentliches Verwaltungsgebäude oder Büroraum eines Kulturgüterverwalters.
-    - leased_by
+          
-    - lease
+          Sekundärer physischer Standort, an dem Back-Office-, Verwaltungs- oder 
-    - has_score
+          Unterstützungsfunktionen ausgeführt werden, die nicht direkt der Öffentlichkeit dienen. 
-    - derive_from
+          Typischerweise beherbergt es Personal, das sich mit Finanzen, HR, IT, Management 
-    - generated_by
+          oder anderen operativen Aktivitäten beschäftigt.
-    slot_usage:
+      fr:
-      identified_by:
+        text: >-
-#         range: string # uriorcurie
+          Bâtiment administratif non public ou espace de bureau d'un dépositaire du patrimoine.
-        required: true
+          
-      has_label:
+          Localisation physique secondaire où sont exécutées des fonctions de back-office, 
-#         range: string
+          administratives ou de soutien qui ne servent pas directement le public. 
-        required: true
+          Abrite généralement du personnel effectuant des activités financières, RH, IT, 
-      has_description:
+          de gestion ou autres opérations.
-#         range: string
+      es:
-      has_function:
+        text: >-
-        range: FunctionType
+          Edificio administrativo no público o espacio de oficina de un custodio del patrimonio.
-        multivalued: true
+          
-        inlined: true
+          Ubicación física secundaria donde se realizan funciones de back-office, 
-        inlined_as_list: true
+          administrativas o de apoyo que no sirven directamente al público. 
-        examples:
+          Por lo general alberga personal que realiza actividades financieras, de RRHH, 
-        - value:
+          TI, gestión u otras operaciones.
-            function_category: ADMINISTRATIVE
+      ar:
-            function_name: Finance and accounting
+        text: >-
-        - value:
+          مبنى إداري غير عام أو مساحة مكتبية لأمين التراث.
-            function_category: ADMINISTRATIVE
+          
-            function_name: Human resources
+          موقع مادي ثانوي حيث تُنفذ وظائف المكتب الخلفي أو الإدارية أو الداعمة 
-        - value:
+          التي لا تخدم الجمهور مباشرة. عادة ما يضم موظفين يقومون بأنشطة مالية 
-            function_category: SUPPORT
+          أو موارد بشرية أو تكنولوجيا معلومات أو إدارة أو أنشطة تشغيلية أخرى.
-            function_name: Information technology
+      id:
-        - value: Management access only
+        text: >-
-      has_staff:
+          Bangunan administratif non-publik atau ruang kantor pengelola warisan.
-        range: Staff
+          
-        multivalued: true
+          Lokasi fisik sekunder tempat fungsi back-office, administratif, atau dukungan 
-        inlined: true
+          dilakukan yang tidak melayani publik secara langsung. Biasanya menampung staf 
-        examples:
+          yang melakukan aktivitas keuangan, SDM, IT, manajemen, atau operasional lainnya.
-        - value:
+      zh:
-            has_quantity:
+        text: >-
-              has_value: 25
+          遗产保管人的非公共行政建筑或办公空间。
-              has_measurement_unit:
+          
-                has_label: "FTE"
+          执行不直接服务于公众的后台、行政或支持职能的次要物理位置。
-            has_type:
+          通常容纳从事财务、人力资源、IT、管理或其他运营活动的员工。
-              has_label: "Administrative Staff"
-      leased_by:
-        range: boolean
-        examples:
-        - value: true
-        - value: false
-      lease:
-        range: date
-        examples:
-        - value: '2028-12-31'
-      derive_from:
-#         range: string # CustodianObservation
-        multivalued: true
-        required: false
-      generated_by:
-        range: ReconstructionActivity
-        required: false
-    comments:
-    - AdministrativeOffice models non-public back-office locations
-    - Distinguished from BranchOffice by lack of public access
-    - W3C ORG org:Site specialized for administrative functions
-    - Often in separate building from main heritage operations
-    - May be leased rather than owned for cost efficiency
-    - 'MIGRATION NOTE: has_administrative_function replaced by generic has_function (Rule 53)'
-    see_also:
-    - https://www.w3.org/TR/vocab-org/#org:Site
-    - https://schema.org/Corporation
     examples:
     - value:
         identified_by:
@@ -130,43 +103,134 @@ classes:
           function_name: Human resources
         - function_category: SUPPORT
           function_name: Information technology
-        - function_category: ADMINISTRATIVE
-          function_name: Legal affairs
         has_staff:
         - has_quantity:
             has_value: 45
             has_unit:
-              has_label: "FTE"
+              has_label: FTE
           has_type:
-            has_label: "Administrative Staff"
+            has_label: Administrative Staff
-        is_leased: true
+        leased_by: true
-        lease_expiry: '2028-12-31'
+        lease: '2028-12-31'
-    - value:
+      description: Administrative annex in business district
-        identified_by:
+    broad_mappings:
-          identifier_value: https://nde.nl/ontology/hc/aux/kb-digitization-center
+    - org:Site
-        has_label:
+    close_mappings:
-          has_label: Koninklijke Bibliotheek Digitization Support Center
+    - schema:Place
-        has_description:
+    - crm:E27_Site
-          has_content:
+    related_mappings:
-            has_description: Technical support center for digitization operations. Houses scanning equipment coordination and quality control.
+    - schema:Corporation
-          description_type: admin_office
+    - org:OrganizationalUnit
-        has_function:
+    structured_aliases:
-        - function_category: PROGRAM
+    - literal_form: administratief kantoor
-          function_name: Digitization project management
+      in_language: nl
-        - function_category: SUPPORT
+    - literal_form: backoffice
-          function_name: Quality control
+      in_language: nl
-        - function_category: SUPPORT
+    - literal_form: Verwaltungsbüro
-          function_name: Technical support
+      in_language: de
-        has_staff:
+    - literal_form: Backoffice
-        - has_quantity:
+      in_language: de
-            has_value: 12
+    - literal_form: bureau administratif
-            has_unit:
+      in_language: fr
-              has_label: "FTE"
+    - literal_form: oficinas administrativas
-          has_type:
+      in_language: es
-            has_label: "Technical Staff"
+    - literal_form: مكتب إداري
-        is_leased: false
+      in_language: ar
-        lease_expiry: null
+    - literal_form: kantor administratif
+      in_language: id
+    - literal_form: 行政办公室
+      in_language: zh
+    keywords:
+    - administrative office
+    - back-office
+    - support services
+    - staff-only
+    - non-public
+    - headquarters
+    - annex
+    slots:
+    - has_description
+    - identified_by
+    - has_label
+    - has_staff
+    - has_function
+    - leased_by
+    - lease
+    - has_score
+    - derive_from
+    - generated_by
+    slot_usage:
+      identified_by:
+        required: true
+        examples:
+        - value:
+            identifier_value: https://nde.nl/ontology/hc/aux/rijksmuseum-admin-zuidas
+      has_label:
+        required: true
+        examples:
+        - value: Rijksmuseum Administrative Offices - Zuidas
+      has_description:
+        required: false
+        examples:
+        - value: Administrative support offices housing finance, HR, and IT departments. Staff access only.
+      has_function:
+        range: FunctionType
+        multivalued: true
+        inlined: true
+        inlined_as_list: true
+        examples:
+        - value:
+            function_category: ADMINISTRATIVE
+            function_name: Finance and accounting
+        - value:
+            function_category: ADMINISTRATIVE
+            function_name: Human resources
+        - value:
+            function_category: SUPPORT
+            function_name: Information technology
+      has_staff:
+        range: Staff
+        multivalued: true
+        inlined: true
+        examples:
+        - value:
+            has_quantity:
+              has_value: 25
+              has_measurement_unit:
+                has_label: FTE
+            has_type:
+              has_label: Administrative Staff
+      leased_by:
+        range: boolean
+        examples:
+        - value: true
+        - value: false
+      lease:
+        range: date
+        examples:
+        - value: '2028-12-31'
+      derive_from:
+        multivalued: true
+        required: false
+      generated_by:
+        range: ReconstructionActivity
+        required: false
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.35"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: "Administrative offices are common across heritage custodians but represent a specific auxiliary place type."
       custodian_types: "['*']"
+      distinction_from_branch: "No public access - distinguished from BranchOffice by lack of public service delivery"
+      typical_functions: "Finance, HR, IT, Management, Legal affairs"
+      cost_consideration: "Often in lower-cost location than main building"
+    comments:
+    - AdministrativeOffice models non-public back-office locations
+    - Distinguished from BranchOffice by lack of public access
+    - W3C ORG org:Site specialized for administrative functions
+    - Often in separate building from main heritage operations
+    - May be leased rather than owned for cost efficiency
+    - has_administrative_function replaced by generic has_function (Rule 53)
+    see_also:
+    - https://www.w3.org/TR/vocab-org/#org:Site
+    - https://schema.org/Corporation
+    - BranchOffice
+    - StorageFacility

schemas/20251121/linkml/modules/classes/AdministrativeUnit.yaml

@@ -1,27 +1,155 @@
 id: https://nde.nl/ontology/hc/class/AdministrativeUnit
 name: AdministrativeUnit
-title: AdministrativeUnit
+title: Administrative Unit
-description: >-
-  An administrative division or unit.
-
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
   org: http://www.w3.org/ns/org#
-
+  schema: http://schema.org/
+  skos: http://www.w3.org/2004/02/skos/core#
+  dcterms: http://purl.org/dc/terms/
 default_prefix: hc
-
 imports:
   - linkml:types
   - ../slots/has_name
+  - ../slots/has_description
+  - ../slots/identified_by
 classes:
   AdministrativeUnit:
     class_uri: org:OrganizationalUnit
-    description: Administrative unit.
+    description: >-
-    annotations:
+      Administrative division or unit within an organization.
-      specificity_score: 0.1
-      specificity_rationale: "Generic utility class created during migration"
-      custodian_types: '["*"]'
       
+      Represents a distinct organizational component with defined responsibilities, 
+      reporting structure, and operational scope. May be a department, division, 
+      team, or other organizational subdivision.
+    alt_descriptions:
+      nl:
+        text: >-
+          Administratieve afdeling of eenheid binnen een organisatie.
+          
+          Vertegenwoordigt een duidelijk organisatieonderdeel met gedefinieerde 
+          verantwoordelijkheden, rapportagelijnen en operationele reikwijdte. 
+          Kan een afdeling, divisie, team of andere organisatorische onderverdeling zijn.
+      de:
+        text: >-
+          Administrative Abteilung oder Einheit innerhalb einer Organisation.
+          
+          Repräsentiert eine eigenständige Organisationskomponente mit definierten 
+          Verantwortlichkeiten, Berichtsstruktur und operatives Tätigkeitsfeld. 
+          Kann eine Abteilung, Division, Team oder andere organisatorische Unterteilung sein.
+      fr:
+        text: >-
+          Division administrative ou unité au sein d'une organisation.
+          
+          Représente un composant organisationnel distinct avec des responsabilités 
+          définies, une structure de rapport et une portée opérationnelle. 
+          Peut être un département, une division, une équipe ou autre subdivision organisationnelle.
+      es:
+        text: >-
+          División administrativa o unidad dentro de una organización.
+          
+          Representa un componente organizativo distinto con responsabilidades definidas, 
+          estructura de informes y alcance operativo. Puede ser un departamento, 
+          división, equipo u otra subdivisión organizativa.
+      ar:
+        text: >-
+          قسم إداري أو وحدة داخل منظمة.
+          
+          يمثل مكونًا تنظيميًا متميزًا بمسؤوليات محددة وهيكل إبلاغ ونطاق تشغيلي. 
+          يمكن أن يكون قسمًا أو شعبة أو فريقًا أو تقسيمًا تنظيميًا آخر.
+      id:
+        text: >-
+          Divisi administratif atau unit dalam organisasi.
+          
+          Mewakili komponen organisasi yang berbeda dengan tanggung jawab yang ditentukan, 
+          struktur pelaporan, dan cakupan operasional. Dapat berupa departemen, 
+          divisi, tim, atau subdivisi organisasi lainnya.
+      zh:
+        text: >-
+          组织内的行政部门或单位。
+          
+          代表具有明确职责、汇报结构和运营范围的独立组织组成部分。
+          可以是部门、分部、团队或其他组织细分。
+    examples:
+    - value:
+        has_name: Conservation Department
+        has_description: Responsible for preservation and restoration of collection items
+      description: Conservation department within a museum
+    - value:
+        has_name: Digital Services Division
+        has_description: Manages digitization, digital preservation, and online access
+      description: Digital services division
+    close_mappings:
+    - org:OrganizationalUnit
+    - schema:Organization
+    broad_mappings:
+    - skos:Concept
+    structured_aliases:
+    - literal_form: administratieve eenheid
+      in_language: nl
+    - literal_form: afdeling
+      in_language: nl
+    - literal_form: Verwaltungseinheit
+      in_language: de
+    - literal_form: Abteilung
+      in_language: de
+    - literal_form: unité administrative
+      in_language: fr
+    - literal_form: département
+      in_language: fr
+    - literal_form: unidad administrativa
+      in_language: es
+    - literal_form: departamento
+      in_language: es
+    - literal_form: وحدة إدارية
+      in_language: ar
+    - literal_form: قسم
+      in_language: ar
+    - literal_form: unit administratif
+      in_language: id
+    - literal_form: departemen
+      in_language: id
+    - literal_form: 行政单位
+      in_language: zh
+    - literal_form: 部门
+      in_language: zh
+    keywords:
+    - administrative unit
+    - department
+    - division
+    - team
+    - organizational unit
+    - organizational structure
     slots:
-      - has_name
+    - has_name
+    - has_description
+    - identified_by
+    slot_usage:
+      has_name:
+        required: true
+        examples:
+        - value: Conservation Department
+        - value: Digital Services Division
+        - value: Reader Services Team
+      has_description:
+        required: false
+        examples:
+        - value: Responsible for preservation and restoration of collection items
+      identified_by:
+        required: false
+        examples:
+        - value: https://nde.nl/ontology/hc/admin-unit/conservation-dept
+    annotations:
+      specificity_score: "0.10"
+      specificity_rationale: "Generic utility class - administrative units are broadly applicable across all organizational contexts."
+      custodian_types: "['*']"
+      unit_types: "Department, Division, Team, Section, Unit"
+    comments:
+    - Represents internal organizational divisions
+    - May be hierarchical (departments within divisions)
+    - Used for staff assignment and responsibility tracking
+    see_also:
+    - https://www.w3.org/TR/vocab-org/#org:OrganizationalUnit
+    - Administration
+    - AdministrativeLevel

schemas/20251121/linkml/modules/classes/AdmissionFee.yaml

@@ -1,21 +1,185 @@
 id: https://nde.nl/ontology/hc/class/AdmissionFee
 name: AdmissionFee
-title: AdmissionFee
+title: Admission Fee
-description: >-
-  Fee charged for admission.
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
   schema: http://schema.org/
+  skos: http://www.w3.org/2004/02/skos/core#
+  dcterms: http://purl.org/dc/terms/
 default_prefix: hc
 imports:
   - linkml:types
+  - ../slots/has_price
+  - ../slots/has_description
+  - ../slots/has_label
+  - ../slots/has_type
 classes:
   AdmissionFee:
     class_uri: schema:PriceSpecification
-    description: Admission fee.
+    description: >-
+      Fee charged for admission to a heritage custodian facility or event.
+      
+      Represents pricing information for visitor access to museums, archives, 
+      libraries, or special exhibitions. May include standard rates, 
+      discounted rates, and free admission policies.
+    alt_descriptions:
+      nl:
+        text: >-
+          Tarief dat wordt gerekend voor toegang tot een erfgoedbeheerderfaciliteit of evenement.
+          
+          Vertegenwoordigt prijsinformatie voor bezoekertoegang tot musea, archieven, 
+          bibliotheken of speciale tentoonstellingen. Kan standaardtarieven, 
+          gereduceerde tarieven en gratis toegangsbeleid omvatten.
+      de:
+        text: >-
+          Gebühr für den Einlass zu einer Einrichtung oder Veranstaltung eines Kulturgüterverwalters.
+          
+          Repräsentiert Preisinformationen für den Besucherzugang zu Museen, Archiven, 
+          Bibliotheken oder Sonderausstellungen. Kann Standardtarife, ermäßigte Tarife 
+          und kostenlose Einlasspolitik umfassen.
+      fr:
+        text: >-
+          Frais d'entrée pour l'accès à une installation ou un événement d'un dépositaire du patrimoine.
+          
+          Représente les informations de tarification pour l'accès des visiteurs aux musées, 
+          archives, bibliothèques ou expositions spéciales. Peut inclure les tarifs standard, 
+          les tarifs réduits et les politiques d'entrée gratuite.
+      es:
+        text: >-
+          Tarifa cobrada por la admisión a una instalación o evento de un custodio del patrimonio.
+          
+          Representa información de precios para el acceso de visitantes a museos, 
+          archivos, bibliotecas o exposiciones especiales. Puede incluir tarifas estándar, 
+          tarifas reducidas y políticas de entrada gratuita.
+      ar:
+        text: >-
+          رسم يُفرض للدخول إلى منشأة أو حدث لأمين التراث.
+          
+          يمثل معلومات التسعير لدخول الزوار إلى المتاحف أو الأرشيف أو 
+          المكتبات أو المعارض الخاصة. قد يشمل الأسعار القياسية والأسعار المخفضة 
+          وسياسات الدخول المجاني.
+      id:
+        text: >-
+          Biaya yang dibebankan untuk masuk ke fasilitas atau acara pengelola warisan.
+          
+          Mewakili informasi harga untuk akses pengunjung ke museum, arsip, 
+          perpustakaan, atau pameran khusus. Dapat mencakup tarif standar, 
+          tarif diskon, dan kebijakan masuk gratis.
+      zh:
+        text: >-
+          进入遗产保管人设施或活动所收取的费用。
+          
+          代表访客进入博物馆、档案馆、图书馆或特别展览的定价信息。
+          可能包括标准费率、折扣费率和免费入场政策。
+    examples:
+    - value:
+        has_label: Adult Admission
+        has_price: 20.00
+        has_type: STANDARD
+        has_description: Standard adult admission ticket
+      description: Standard adult admission fee
+    - value:
+        has_label: Student Discount
+        has_price: 10.00
+        has_type: DISCOUNTED
+        has_description: Reduced rate for students with valid ID
+      description: Student discounted admission
+    - value:
+        has_label: Free Admission
+        has_price: 0.00
+        has_type: FREE
+        has_description: No charge for admission
+      description: Free admission policy
+    close_mappings:
+    - schema:Offer
+    related_mappings:
+    - schema:MonetaryAmount
+    broad_mappings:
+    - schema:PriceSpecification
+    - skos:Concept
+    structured_aliases:
+    - literal_form: entreegeld
+      in_language: nl
+    - literal_form: toegangsprijs
+      in_language: nl
+    - literal_form: Eintrittspreis
+      in_language: de
+    - literal_form: Eintrittsgeld
+      in_language: de
+    - literal_form: prix d'entrée
+      in_language: fr
+    - literal_form: droit d'entrée
+      in_language: fr
+    - literal_form: precio de entrada
+      in_language: es
+    - literal_form: tarifa de admisión
+      in_language: es
+    - literal_form: رسوم الدخول
+      in_language: ar
+    - literal_form: سعر التذكرة
+      in_language: ar
+    - literal_form: biaya masuk
+      in_language: id
+    - literal_form: harga tiket
+      in_language: id
+    - literal_form: 入场费
+      in_language: zh
+    - literal_form: 门票价格
+      in_language: zh
+    keywords:
+    - admission fee
+    - entrance fee
+    - ticket price
+    - pricing
+    - discount
+    - free admission
+    - student rate
+    - senior rate
+    slots:
+    - has_label
+    - has_price
+    - has_description
+    - has_type
+    slot_usage:
+      has_label:
+        required: true
+        examples:
+        - value: Adult Admission
+        - value: Student Discount
+        - value: Senior Rate
+        - value: Free Admission
+      has_price:
+        range: float
+        required: true
+        examples:
+        - value: 20.00
+        - value: 10.00
+        - value: 0.00
+      has_description:
+        required: false
+        examples:
+        - value: Standard adult admission ticket
+        - value: Reduced rate for students with valid ID
+      has_type:
+        range: string
+        required: false
+        examples:
+        - value: STANDARD
+        - value: DISCOUNTED
+        - value: FREE
+        - value: MEMBER
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.25"
-      specificity_rationale: "Generic utility class created during migration"
+      specificity_rationale: "Admission fees are common for museums and some heritage sites, but not universally applicable to all custodians."
-      custodian_types: '["*"]'
+      custodian_types: "['Museum', 'Archive', 'Library']"
-    slots: []
+      fee_types: "STANDARD, DISCOUNTED, FREE, MEMBER, GROUP"
+    comments:
+    - Represents pricing for visitor access
+    - May include multiple fee tiers (adult, student, senior, etc.)
+    - Free admission is represented with price of 0.00
+    - Often used with AdmissionInfo for comprehensive visitor information
+    see_also:
+    - AdmissionInfo
+    - https://schema.org/PriceSpecification
+    - https://schema.org/Offer

schemas/20251121/linkml/modules/classes/AdmissionInfo.yaml

@@ -1,32 +1,175 @@
 id: https://nde.nl/ontology/hc/classes/AdmissionInfo
 name: AdmissionInfo
-title: AdmissionInfo
+title: Admission Information
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
   schema: http://schema.org/
   prov: http://www.w3.org/ns/prov#
   xsd: http://www.w3.org/2001/XMLSchema#
+  skos: http://www.w3.org/2004/02/skos/core#
 imports:
   - linkml:types
-# default_range: string
+  - ../slots/has_price
+  - ../slots/has_note
+  - ../slots/has_description
+  - ../slots/has_label
 classes:
   AdmissionInfo:
-    description: "Structured admission price information from Google Maps including\
-      \ price value and notes about additional fees or conditions.\nOntology mapping\
-      \ rationale: - class_uri is schema:PriceSpecification because this represents\n\
-      \  structured price information for museum/institution admission\n- close_mappings\
-      \ includes schema:Offer for commercial offering context - related_mappings includes\
-      \ schema:MonetaryAmount for price values"
     class_uri: schema:PriceSpecification
+    description: >-
+      Structured admission price information including price value and notes.
+      
+      Comprehensive information about admission pricing for heritage custodian 
+      facilities, typically extracted from sources like Google Maps or official 
+      websites. Includes both the price amount and contextual notes about 
+      additional fees, conditions, or special offers.
+    alt_descriptions:
+      nl:
+        text: >-
+          Gestructureerde informatie over entreeprijzen inclusief prijs en notities.
+          
+          Uitgebreide informatie over entreeprijzen voor erfgoedbeheerderfaciliteiten, 
+          doorgaans geëxtraheerd uit bronnen zoals Google Maps of officiële websites. 
+          Omvat zowel het prijsbedrag als contextuele notities over extra kosten, 
+          voorwaarden of speciale aanbiedingen.
+      de:
+        text: >-
+          Strukturierte Eintrittspreisinformationen einschließlich Preiswert und Hinweisen.
+          
+          Umfassende Informationen über Eintrittspreise für Einrichtungen von 
+          Kulturgüterverwaltern, typischerweise aus Quellen wie Google Maps oder 
+          offiziellen Websites extrahiert. Enthält sowohl den Preisbetrag als auch 
+          kontextuelle Hinweise zu zusätzlichen Gebühren, Bedingungen oder Sonderangeboten.
+      fr:
+        text: >-
+          Informations structurées sur les prix d'entrée, y compris la valeur et les notes.
+          
+          Informations complètes sur les tarifs d'entrée pour les installations 
+          des dépositaires du patrimoine, généralement extraites de sources telles que 
+          Google Maps ou des sites Web officiels. Inclut à la fois le montant du prix 
+          et des notes contextuelles sur les frais supplémentaires, les conditions ou les offres spéciales.
+      es:
+        text: >-
+          Información estructurada sobre precios de admisión incluyendo valor y notas.
+          
+          Información integral sobre precios de admisión para instalaciones de 
+          custodios del patrimonio, típicamente extraída de fuentes como Google Maps 
+          o sitios web oficiales. Incluye tanto el monto del precio como notas 
+          contextuales sobre tarifas adicionales, condiciones u ofertas especiales.
+      ar:
+        text: >-
+          معلومات منظمة عن أسعار الدخول تشمل القيمة والملاحظات.
+          
+          معلومات شاملة عن تسعير الدخول لمنشآت أمناء التراث، تُستخرج عادة من 
+          مصادر مثل خرائط جوجل أو المواقع الرسمية. تتضمن كل من مبلغ السعر 
+          والملاحظات السياقية حول الرسوم الإضافية أو الشروط أو العروض الخاصة.
+      id:
+        text: >-
+          Informasi harga masuk terstruktur termasuk nilai harga dan catatan.
+          
+          Informasi komprehensif tentang harga masuk untuk fasilitas pengelola warisan, 
+          biasanya diekstrak dari sumber seperti Google Maps atau situs web resmi. 
+          Termasuk jumlah harga dan catatan kontekstual tentang biaya tambahan, 
+          kondisi, atau penawaran khusus.
+      zh:
+        text: >-
+          包含价格值和注释的结构化入场价格信息。
+          
+          遗产保管人设施入场定价的综合信息，通常从 Google 地图或官方网站等来源提取。
+          包括价格金额以及关于额外费用、条件或特别优惠的上下文注释。
+    examples:
+    - value:
+        has_label: General Admission
+        has_price: 15.00
+        has_note: Audio guide available for additional €5
+      description: Museum admission with optional audio guide
+    - value:
+        has_label: Free Entry
+        has_price: 0.00
+        has_note: Free admission on the first Sunday of each month
+      description: Free admission policy with conditions
     close_mappings:
     - schema:Offer
     related_mappings:
     - schema:MonetaryAmount
-    annotations:
+    broad_mappings:
-      specificity_score: 0.1
+    - skos:Concept
-      specificity_rationale: Generic utility class/slot created during migration
+    structured_aliases:
-      custodian_types: '[''*'']'
+    - literal_form: toegangsinformatie
+      in_language: nl
+    - literal_form: entreeprijsinformatie
+      in_language: nl
+    - literal_form: Eintrittsinformationen
+      in_language: de
+    - literal_form: Zutrittsinformationen
+      in_language: de
+    - literal_form: informations d'entrée
+      in_language: fr
+    - literal_form: informations d'admission
+      in_language: fr
+    - literal_form: información de admisión
+      in_language: es
+    - literal_form: información de entrada
+      in_language: es
+    - literal_form: معلومات الدخول
+      in_language: ar
+    - literal_form: معلومات القبول
+      in_language: ar
+    - literal_form: informasi masuk
+      in_language: id
+    - literal_form: informasi penerimaan
+      in_language: id
+    - literal_form: 入场信息
+      in_language: zh
+    - literal_form: 入场须知
+      in_language: zh
+    keywords:
+    - admission information
+    - pricing
+    - entrance fee
+    - ticket information
+    - visitor information
     slots:
     - has_price
     - has_note
+    - has_label
+    - has_description
+    slot_usage:
+      has_price:
+        range: float
+        required: false
+        examples:
+        - value: 15.00
+        - value: 0.00
+      has_note:
+        required: false
+        multivalued: true
+        examples:
+        - value: Audio guide available for additional €5
+        - value: Free admission on the first Sunday of each month
+        - value: Group discounts available
+      has_label:
+        required: false
+        examples:
+        - value: General Admission
+        - value: Student Rate
+        - value: Free Entry
+      has_description:
+        required: false
+        examples:
+        - value: Standard museum admission ticket
+    annotations:
+      specificity_score: "0.25"
+      specificity_rationale: "Admission information is common for museums but not universally applicable to all custodians."
+      custodian_types: "['Museum', 'Archive', 'Library']"
+      data_sources: "Google Maps, official websites, visitor information systems"
+    comments:
+    - Structured pricing information from various sources
+    - May include notes about conditions, discounts, or additional fees
+    - Price of 0.00 indicates free admission
+    - Often extracted from Google Maps or official websites
+    see_also:
+    - AdmissionFee
+    - https://schema.org/PriceSpecification
+    - https://schema.org/Offer

schemas/20251121/linkml/modules/classes/AdvertisingRadioArchive.yaml

@@ -3,6 +3,11 @@ name: AdvertisingRadioArchive
 title: Advertising Radio Archive Type
 prefixes:
   linkml: https://w3id.org/linkml/
+  hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  schema: http://schema.org/
+  rico: https://www.ica.org/standards/RiC/ontology#
+  wd: http://www.wikidata.org/entity/
 imports:
   - linkml:types
   - ../slots/identified_by
@@ -10,58 +15,145 @@ imports:
   - ../slots/has_type
   - ../slots/hold_record_set
   - ../slots/related_to
+  - ../slots/has_label
+  - ../slots/has_description
 classes:
   AdvertisingRadioArchive:
     is_a: ArchiveOrganizationType
     class_uri: skos:Concept
-    slots:
+    description: >-
-    - hold_record_set
+      Sound archive specializing in advertising radio productions and commercials.
-    - has_score
-    description: 'Sound archive specializing in advertising radio productions and commercials.
       
+      Preserves radio commercials, jingles, advertising campaigns for radio 
+      broadcast, production materials including scripts, recordings, and masters, 
+      and historical radio advertising content.
+    alt_descriptions:
+      nl:
+        text: >-
+          Geluidsarchief gespecialiseerd in radioadvertenties en commercials.
           
-      **Wikidata**: Q60658673
+          Bewaart radiocommercials, jingles, advertentiecampagnes voor radio-uitzendingen, 
+          productiematerialen inclusief scripts, opnames en masters, en historische 
+          radioadvertentie-inhoud.
+      de:
+        text: >-
+          Audioarchiv, spezialisiert auf Werbefunksendungen und Werbespots.
           
+          Bewahrt Werbespots, Jingles, Werbekampagnen für Hörfunk, Produktionsmaterialien 
+          einschließlich Drehbüchern, Aufnahmen und Mastern sowie historische 
+          Werbefunkinhalte auf.
+      fr:
+        text: >-
+          Archives sonores spécialisées dans les productions publicitaires radio et les commercials.
           
-      **Scope**:
+          Conserve les spots publicitaires radio, les jingles, les campagnes publicitaires 
+          pour la diffusion radio, les matériaux de production y compris les scripts, 
+          les enregistrements et les masters, ainsi que le contenu publicitaire radio historique.
+      es:
+        text: >-
+          Archivo de sonido especializado en producciones publicitarias de radio y comerciales.
           
-      Advertising radio archives preserve:
+          Preserva comerciales de radio, jingles, campañas publicitarias para transmisión 
+          radiofónica, materiales de producción incluyendo guiones, grabaciones y masters, 
+          y contenido publicitario radiofónico histórico.
+      ar:
+        text: >-
+          أرشيف صوتي متخصص في إعلانات الراديو والإعلانات التجارية.
           
-      - Radio commercials and jingles
+          يحفظ إعلانات الراديو والجنقات وحملات الإعلان للبث الإذاعي ومواد الإنتاج 
+          بما في ذلك النصوص والتسجيلات والماسترات والمحتوى الإعلاني الإذاعي التاريخي.
+      id:
+        text: >-
+          Arsip suara yang berspesialisasi dalam produksi iklan radio dan komersial.
           
-      - Advertising campaigns for radio broadcast
+          Melestarikan iklan radio, jingle, kampanye iklan untuk siaran radio, 
+          bahan produksi termasuk naskah, rekaman, dan master, serta konten 
+          iklan radio historis.
+      zh:
+        text: >-
+          专门从事广播广告制作和商业广告的音频档案。
           
-      - Production materials (scripts, recordings, masters)
+          保存广播商业广告、广告歌、广播广告活动、制作材料（包括剧本、录音和母带）
-
+          以及历史广播广告内容。
-      - Historical radio advertising content
+    examples:
-
+    - value:
-
+        has_type: hc:ArchiveOrganizationType
-      **Related Types**:
+        has_label: Radio Advertising Archive
-
+        hold_record_set:
-      - SoundArchive (Q2230431) - Broader audio collection type
+        - hc:RadioAdvertisementCollection
-
+        - hc:CampaignDocumentationSeries
-      - RadioArchive (Q109326271) - General radio broadcast archives
+      description: Archive specializing in radio advertising materials
-
-      - MediaArchive (Q116809817) - Broader media preservation
-
-      '
-    slot_usage:
-      identified_by:
-        pattern: ^Q[0-9]+$
     exact_mappings:
-    - skos:Concept
+    - wd:Q60658673
     close_mappings:
     - schema:ArchiveOrganization
     - rico:CorporateBody
+    broad_mappings:
+    - wd:Q2230431
+    - skos:Concept
+    related_mappings:
+    - wd:Q109326271
+    structured_aliases:
+    - literal_form: reclameradioarchief
+      in_language: nl
+    - literal_form: advertentieradioarchief
+      in_language: nl
+    - literal_form: Werbefunkarchiv
+      in_language: de
+    - literal_form: Radioanzeigenarchiv
+      in_language: de
+    - literal_form: archives publicitaires radio
+      in_language: fr
+    - literal_form: archivo de publicidad radiofónica
+      in_language: es
+    - literal_form: أرشيف إعلانات الراديو
+      in_language: ar
+    - literal_form: arsip iklan radio
+      in_language: id
+    - literal_form: 广播广告档案馆
+      in_language: zh
+    keywords:
+    - advertising archive
+    - radio archive
+    - commercial archive
+    - jingles
+    - radio commercials
+    - advertising history
+    - broadcasting archive
+    slots:
+    - hold_record_set
+    - has_score
+    - has_type
+    - identified_by
+    - has_label
+    - has_description
+    - related_to
+    slot_usage:
+      identified_by:
+        pattern: "^Q[0-9]+$"
+        examples:
+        - value: Q60658673
+      has_label:
+        required: false
+        examples:
+        - value: Radio Advertising Archive
+      has_description:
+        required: false
+        examples:
+        - value: Sound archive specializing in advertising radio productions and commercials
+    annotations:
+      specificity_score: "0.55"
+      specificity_rationale: "Highly specific archive type - advertising radio archives are a specialized subset of sound archives."
+      custodian_types: "['AdvertisingRadioArchive']"
+      wikidata_qid: "Q60658673"
+      related_types: "SoundArchive (Q2230431), RadioArchive (Q109326271)"
     comments:
     - Specialized sound archive for advertising radio content
-    - 'Part of dual-class pattern: custodian type + rico:RecordSetType'
+    - Part of dual-class pattern: custodian type + rico:RecordSetType
     - Often associated with broadcasting organizations or advertising agencies
+    - Holds record sets like RadioAdvertisementCollection, CampaignDocumentationSeries
     see_also:
-    - SoundArchive
+    - AdvertisingRadioArchiveRecordSetType
-    - RadioArchive
+    - AdvertisingRadioArchiveRecordSetTypes
-    - MediaArchive
+    - wd:Q2230431
-    annotations:
+    - wd:Q109326271
-      specificity_score: 0.1
-      specificity_rationale: Generic utility class/slot created during migration
-      custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/AdvertisingRadioArchiveRecordSetType.yaml

@@ -1,34 +1,143 @@
 id: https://nde.nl/ontology/hc/class/AdvertisingRadioArchiveRecordSetType
 name: AdvertisingRadioArchiveRecordSetType
-title: AdvertisingRadioArchive Record Set Type
+title: Advertising Radio Archive Record Set Type
 prefixes:
   linkml: https://w3id.org/linkml/
+  hc: https://nde.nl/ontology/hc/
   wd: http://www.wikidata.org/entity/
+  skos: http://www.w3.org/2004/02/skos/core#
+  rico: https://www.ica.org/standards/RiC/ontology#
+  schema: http://schema.org/
 imports:
   - linkml:types
   - ../slots/has_score
   - ../slots/has_type
   - ../slots/related_to
+  - ../slots/has_label
+  - ../slots/has_description
 classes:
   AdvertisingRadioArchiveRecordSetType:
-    description: A rico:RecordSetType for classifying collections of advertising radio  productions and commercials within heritage institutions.
+    description: >-
+      Record set type classification for advertising radio production collections.
+      
+      Specialized rico:RecordSetType for classifying collections of advertising 
+      radio productions, commercials, and related documentation within heritage 
+      institutions. Distinguishes different organizational levels and content 
+      types held by advertising radio archives.
+    alt_descriptions:
+      nl:
+        text: >-
+          Recordsettype-classificatie voor collecties van radioadvertentieproducties.
+          
+          Gespecialiseerd rico:RecordSetType voor het classificeren van collecties 
+          van radioadvertentieproducties, commercials en gerelateerde documentatie 
+          binnen erfgoedinstituties.
+      de:
+        text: >-
+          Bestandstyp-Klassifikation für Sammlungen von Werbefunkproduktionen.
+          
+          Spezialisierter rico:RecordSetType zur Klassifizierung von Sammlungen 
+          von Werbefunkproduktionen, Werbespots und verwandter Dokumentation 
+          in Kulturerbeeinrichtungen.
+      fr:
+        text: >-
+          Classification du type de fonds pour les collections de productions publicitaires radio.
+          
+          rico:RecordSetType spécialisé pour classer les collections de productions 
+          publicitaires radio, de commercials et de documentation connexe dans 
+          les institutions patrimoniales.
+      es:
+        text: >-
+          Clasificación de tipo de conjunto documental para colecciones de producciones publicitarias de radio.
+          
+          rico:RecordSetType especializado para clasificar colecciones de producciones 
+          publicitarias de radio, comerciales y documentación relacionada en 
+          instituciones patrimoniales.
+      ar:
+        text: >-
+          تصنيف نوع مجموعة السجلات لمجموعات إنتاج إعلانات الراديو.
+          
+          Rico:RecordSetType متخصص لتصنيف مجموعات إنتاج إعلانات الراديو 
+          والإعلانات التجارية والوثائق ذات الصلة في مؤسسات التراث.
+      id:
+        text: >-
+          Klasifikasi tipe set rekaman untuk koleksi produksi iklan radio.
+          
+          Rico:RecordSetType khusus untuk mengklasifikasikan koleksi produksi 
+          iklan radio, komersial, dan dokumentasi terkait di institusi warisan.
+      zh:
+        text: >-
+          广播广告制作收藏的记录集类型分类。
+          
+          专门化的 rico:RecordSetType，用于对遗产机构中广播广告制作、
+          商业广告和相关文档的收藏进行分类。
+    examples:
+    - value:
+        has_type: hc:ArchiveOrganizationType
+        has_label: Radio Advertisement Collection
+        has_description: Collection of radio commercial recordings
+      description: Collection of radio commercials
     is_a: CollectionType
     class_uri: rico:RecordSetType
-    exact_mappings:
+    broad_mappings:
+    - rico:RecordSetType
+    - skos:Concept
+    related_mappings:
     - wd:Q60658673
-    slot_usage:
+    structured_aliases:
-      has_type:
+    - literal_form: reclameradioarchief-recordsettype
-        equals_expression: '["hc:ArchiveOrganizationType"]'
+      in_language: nl
-      related_to:
+    - literal_form: Werbefunkarchiv-Bestandstyp
-        range: WikidataAlignment
+      in_language: de
-        inlined: true
+    - literal_form: type de fonds d'archives publicitaires radio
-    see_also:
+      in_language: fr
-    - AdvertisingRadioArchive
+    - literal_form: tipo de conjunto de archivo de publicidad radiofónica
+      in_language: es
+    - literal_form: نوع مجموعة سجلات أرشيف إعلانات الراديو
+      in_language: ar
+    - literal_form: tipe set rekaman arsip iklan radio
+      in_language: id
+    - literal_form: 广播广告档案记录集类型
+      in_language: zh
+    keywords:
+    - record set type
+    - advertising radio
+    - radio commercials
+    - jingles
+    - campaign documentation
+    - archival classification
     slots:
     - has_type
     - has_score
     - related_to
+    - has_label
+    - has_description
+    slot_usage:
+      has_type:
+        equals_string: "hc:ArchiveOrganizationType"
+      related_to:
+        range: WikidataAlignment
+        inlined: true
+      has_label:
+        required: false
+        examples:
+        - value: Radio Advertisement Collection
+        - value: Campaign Documentation Series
+      has_description:
+        required: false
+        examples:
+        - value: Collection of radio commercial recordings from advertising agencies
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.50"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: "Specialized record set type for advertising radio archives - a specific subset of archival classifications."
-      custodian_types: "['*']"
+      custodian_types: "['AdvertisingRadioArchive']"
+      wikidata_note: "Q60658673 is the archive organization type, not the record set type - used as related_mapping"
+    comments:
+    - Specialized record set type for advertising radio archive collections
+    - Part of dual-class pattern: AdvertisingRadioArchive (custodian) + this class (holdings)
+    - Subclasses include RadioAdvertisementCollection, CampaignDocumentationSeries
+    - Q60658673 is related_mapping (archive organization), not exact_mapping (this is a classification)
+    see_also:
+    - AdvertisingRadioArchive
+    - AdvertisingRadioArchiveRecordSetTypes
+    - rico:RecordSetType

schemas/20251121/linkml/modules/classes/AdvertisingRadioArchiveRecordSetTypes.yaml

@@ -1,6 +1,6 @@
 id: https://nde.nl/ontology/hc/class/AdvertisingRadioArchiveRecordSetTypes
 name: AdvertisingRadioArchiveRecordSetTypes
-title: AdvertisingRadioArchive Record Set Type Subclasses
+title: Advertising Radio Archive Record Set Type Subclasses
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
@@ -17,70 +17,231 @@ imports:
   - ../slots/has_type
   - ../slots/has_custodian
   - ../slots/has_note
+  - ../slots/has_label
+  - ../slots/has_description
 classes:
   RadioAdvertisementCollection:
     is_a: AdvertisingRadioArchiveRecordSetType
     class_uri: rico:RecordSetType
-    description: "A rico:RecordSetType for Radio commercial recordings.\n\n**RiC-O\
+    description: >-
-      \ Alignment**:\nThis class is a specialized rico:RecordSetType following the\
+      Record set type for radio commercial recordings.
-      \ collection \norganizational principle as defined by rico-rst:Collection.\n"
+      
+      RiC-O alignment: Specialized rico:RecordSetType following the collection 
+      organizational principle as defined by rico-rst:Collection.
+    alt_descriptions:
+      nl:
+        text: >-
+          Recordsettype voor radiocommercial-opnamen.
+          
+          RiC-O-uitlijning: Gespecialiseerd rico:RecordSetType volgens het 
+          collectie-organisatieprincipe zoals gedefinieerd door rico-rst:Collection.
+      de:
+        text: >-
+          Bestandstyp für Werbefunkaufnahmen.
+          
+          RiC-O-Ausrichtung: Spezialisierter rico:RecordSetType nach dem 
+          Sammlungsorganisationsprinzip wie von rico-rst:Collection definiert.
+      fr:
+        text: >-
+          Type de fonds pour les enregistrements de spots publicitaires radio.
+          
+          Alignement RiC-O: rico:RecordSetType spécialisé suivant le principe 
+          d'organisation de collection défini par rico-rst:Collection.
+      es:
+        text: >-
+          Tipo de conjunto documental para grabaciones de comerciales de radio.
+          
+          Alineación RiC-O: rico:RecordSetType especializado siguiendo el principio 
+          de organización de colección definido por rico-rst:Collection.
+      ar:
+        text: >-
+          نوع مجموعة السجلات لتسجيلات إعلانات الراديو.
+          
+          محاذاة RiC-O: Rico:RecordSetType متخصص يتبع مبدأ تنظيم المجموعة 
+          كما هو محدد بواسطة rico-rst:Collection.
+      id:
+        text: >-
+          Tipe set rekaman untuk rekaman iklan radio.
+          
+          Penyelarasan RiC-O: Rico:RecordSetType khusus mengikuti prinsip 
+          organisasi koleksi seperti yang didefinisikan oleh rico-rst:Collection.
+      zh:
+        text: >-
+          广播商业广告录音的记录集类型。
+          
+          RiC-O 对齐：遵循 rico-rst:Collection 定义的组织原则的专门化 rico:RecordSetType。
+    examples:
+    - value:
+        has_label: Radio Commercials Collection
+        has_description: Collection of radio commercial recordings from 1960s-2000s
+        has_type: hc:ArchiveOrganizationType
+        has_custodian: AdvertisingRadioArchive
+      description: Radio commercial recordings collection
     broad_mappings:
     - rico:RecordSetType
     related_mappings:
     - rico-rst:Collection
     close_mappings:
     - skos:Concept
-    see_also:
+    structured_aliases:
-    - AdvertisingRadioArchiveRecordSetType
+    - literal_form: radiocommercial-collectie
-    - rico:RecordSetType
+      in_language: nl
+    - literal_form: Werbefunksammlung
+      in_language: de
+    - literal_form: collection de spots publicitaires radio
+      in_language: fr
+    - literal_form: colección de comerciales de radio
+      in_language: es
+    - literal_form: مجموعة إعلانات الراديو
+      in_language: ar
+    - literal_form: koleksi iklan radio
+      in_language: id
+    - literal_form: 广播商业广告收藏
+      in_language: zh
+    keywords:
+    - radio commercials
+    - advertising recordings
+    - jingles
+    - radio spots
     slots:
     - has_type
     - has_score
     - has_custodian
-    - record_holder_note
+    - has_note
-    - has_type
+    - has_label
+    - has_description
     slot_usage:
       has_type:
-        equals_expression: '["hc:ArchiveOrganizationType"]'
+        any_of:
-      has_type:
+        - equals_string: "hc:ArchiveOrganizationType"
-        equals_string: RadioAdvertisementCollection
+        - equals_string: "RadioAdvertisementCollection"
       has_custodian:
-        equals_string: AdvertisingRadioArchive
+        equals_string: "AdvertisingRadioArchive"
-      record_holder_note:
+      has_note:
-        equals_string: This RecordSetType is typically held by AdvertisingRadioArchive
+        equals_string: "This RecordSetType is typically held by AdvertisingRadioArchive custodians. Inverse of rico:isOrWasHolderOf."
-          custodians. Inverse of rico:isOrWasHolderOf.
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.50"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: "Specialized record set type for radio commercial collections."
-      custodian_types: '[''*'']'
+      custodian_types: "['AdvertisingRadioArchive']"
+      rico_organizational_principle: "Collection"
+    comments:
+    - Specialized collection for radio commercial recordings
+    - Follows rico-rst:Collection organizational principle
+    - Typically held by AdvertisingRadioArchive custodians
+    see_also:
+    - AdvertisingRadioArchiveRecordSetType
+    - AdvertisingRadioArchive
+    - rico:RecordSetType
   CampaignDocumentationSeries:
     is_a: AdvertisingRadioArchiveRecordSetType
     class_uri: rico:RecordSetType
-    description: "A rico:RecordSetType for Advertising campaign records.\n\n**RiC-O\
+    description: >-
-      \ Alignment**:\nThis class is a specialized rico:RecordSetType following the\
+      Record set type for advertising campaign documentation.
-      \ series \norganizational principle as defined by rico-rst:Series.\n"
+      
+      RiC-O alignment: Specialized rico:RecordSetType following the series 
+      organizational principle as defined by rico-rst:Series.
+    alt_descriptions:
+      nl:
+        text: >-
+          Recordsettype voor documentatie van advertentiecampagnes.
+          
+          RiC-O-uitlijning: Gespecialiseerd rico:RecordSetType volgens het 
+          serie-organisatieprincipe zoals gedefinieerd door rico-rst:Series.
+      de:
+        text: >-
+          Bestandstyp für Werbekampagnendokumentation.
+          
+          RiC-O-Ausrichtung: Spezialisierter rico:RecordSetType nach dem 
+          Serienorganisationsprinzip wie von rico-rst:Series definiert.
+      fr:
+        text: >-
+          Type de fonds pour la documentation de campagnes publicitaires.
+          
+          Alignement RiC-O: rico:RecordSetType spécialisé suivant le principe 
+          d'organisation de série défini par rico-rst:Series.
+      es:
+        text: >-
+          Tipo de conjunto documental para documentación de campañas publicitarias.
+          
+          Alineación RiC-O: rico:RecordSetType especializado siguiendo el principio 
+          de organización de serie definido por rico-rst:Series.
+      ar:
+        text: >-
+          نوع مجموعة السجلات لوثائق الحملات الإعلانية.
+          
+          محاذاة RiC-O: Rico:RecordSetType متخصص يتبع مبدأ تنظيم السلسلة 
+          كما هو محدد بواسطة rico-rst:Series.
+      id:
+        text: >-
+          Tipe set rekaman untuk dokumentasi kampanye iklan.
+          
+          Penyelarasan RiC-O: Rico:RecordSetType khusus mengikuti prinsip 
+          organisasi seri seperti yang didefinisikan oleh rico-rst:Series.
+      zh:
+        text: >-
+          广告活动文档的记录集类型。
+          
+          RiC-O 对齐：遵循 rico-rst:Series 定义的组织原则的专门化 rico:RecordSetType。
+    examples:
+    - value:
+        has_label: Campaign Documentation Series
+        has_description: Series of advertising campaign planning documents and production materials
+        has_type: hc:ArchiveOrganizationType
+        has_custodian: AdvertisingRadioArchive
+      description: Advertising campaign documentation
     broad_mappings:
     - rico:RecordSetType
     related_mappings:
     - rico-rst:Series
     close_mappings:
     - skos:Concept
-    see_also:
+    structured_aliases:
-    - AdvertisingRadioArchiveRecordSetType
+    - literal_form: campagnedocumentatie-serie
-    - rico:RecordSetType
+      in_language: nl
+    - literal_form: Kampagnendokumentationsreihe
+      in_language: de
+    - literal_form: série de documentation de campagne
+      in_language: fr
+    - literal_form: serie de documentación de campaña
+      in_language: es
+    - literal_form: سلسلة وثائق الحملات
+      in_language: ar
+    - literal_form: seri dokumentasi kampanye
+      in_language: id
+    - literal_form: 活动文档系列
+      in_language: zh
+    keywords:
+    - campaign documentation
+    - advertising campaigns
+    - production materials
+    - campaign planning
+    - creative briefs
     slots:
     - has_type
     - has_score
     - has_custodian
-    - record_holder_note
+    - has_note
-    - has_type
+    - has_label
+    - has_description
     slot_usage:
       has_type:
-        equals_expression: '["hc:ArchiveOrganizationType"]'
+        any_of:
-      has_type:
+        - equals_string: "hc:ArchiveOrganizationType"
-        equals_string: CampaignDocumentationSeries
+        - equals_string: "CampaignDocumentationSeries"
       has_custodian:
-        equals_string: AdvertisingRadioArchive
+        equals_string: "AdvertisingRadioArchive"
-      record_holder_note:
+      has_note:
-        equals_string: This RecordSetType is typically held by AdvertisingRadioArchive
+        equals_string: "This RecordSetType is typically held by AdvertisingRadioArchive custodians. Inverse of rico:isOrWasHolderOf."
-          custodians. Inverse of rico:isOrWasHolderOf.
+    annotations:
+      specificity_score: "0.50"
+      specificity_rationale: "Specialized record set type for campaign documentation."
+      custodian_types: "['AdvertisingRadioArchive']"
+      rico_organizational_principle: "Series"
+    comments:
+    - Specialized series for advertising campaign documentation
+    - Follows rico-rst:Series organizational principle
+    - Typically held by AdvertisingRadioArchive custodians
+    see_also:
+    - AdvertisingRadioArchiveRecordSetType
+    - AdvertisingRadioArchive
+    - rico:RecordSetType

schemas/20251121/linkml/modules/classes/Age.yaml

@@ -1,6 +1,6 @@
 id: https://nde.nl/ontology/hc/class/Age
 name: Age
-title: Age Class
+title: Age
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
@@ -15,21 +15,68 @@ imports:
 classes:
   Age:
     class_uri: schema:QuantitativeValue
-    description: 'Represents an age or age range.
+    description: >-
-
+      Temporal span of existence measured in units of time, typically applied to
-
+      persons, objects, or entities. Expressed as a single value or range with
-      **Examples**:
+      an optional unit of measurement.
-
+    alt_descriptions:
-      - "18 years"
+      nl: >-
-
+        Tijdsduur van het bestaan gemeten in tijdseenheden, typisch toegepast op
-      - "25-35 years"
+        personen, objecten of entiteiten. Uitgedrukt als een enkele waarde of
-
+        bereik met een optionele meeteenheid.
-
+      de: >-
-      **Ontological Alignment**:
+        Zeitlicher Bestandszeitraum gemessen in Zeiteinheiten, typischerweise auf
-
+        Personen, Objekte oder Entitaeten angewendet. Ausgedrueckt als einzelner
-      - `schema:QuantitativeValue`: Allows specifying value, minValue, maxValue, and unitCode.
+        Wert oder Bereich mit optionaler Masseinheit.
-
+      fr: >-
-      '
+        Duree d'existence mesuree en unites de temps, generalement appliquee aux
+        personnes, objets ou entites. Exprimee comme une valeur unique ou une
+        plage avec une unite de mesure optionnelle.
+      es: >-
+        Extension temporal de existencia medida en unidades de tiempo,
+        tipicamente aplicada a personas, objetos o entidades. Expresada como un
+        valor unico o rango con una unidad de medida opcional.
+      ar: >-
+        المدة الزمنية للوجود مقاسة بوحدات الوقت، وتطبق عادة على الأشخاص أو
+        الكائنات أو الكيانات. معبراً عنها كقيمة مفردة أو نطاق مع وحدة قياس
+        اختيارية.
+      id: >-
+        Rentang waktu keberadaan yang diukur dalam satuan waktu, biasanya
+        diterapkan pada orang, benda, atau entitas. Dinyatakan sebagai nilai
+        tunggal atau rentang dengan satuan pengukuran opsional.
+      zh: >-
+        以时间单位衡量的存在时间跨度，通常应用于人、物体或实体。表示为单个值或
+        范围，带有可选的度量单位。
+    examples:
+    - value:
+        has_quantity: 18
+        has_measurement_unit: years
+      description: A person's age of 18 years
+    - value:
+        has_quantity: 25
+        has_measurement_unit: years
+      description: Minimum age in a range
+    structured_aliases:
+    - literal_form: leeftijd
+      in_language: nl
+    - literal_form: Alter
+      in_language: de
+    - literal_form: age
+      in_language: fr
+    - literal_form: edad
+      in_language: es
+    - literal_form: عمر
+      in_language: ar
+    - literal_form: usia
+      in_language: id
+    - literal_form: 年龄
+      in_language: zh
+    keywords:
+    - temporal span
+    - duration
+    - years
+    - time measurement
+    - demographic
     slots:
     - has_quantity
     - has_measurement_unit
@@ -39,9 +86,13 @@ classes:
         range: integer
         required: true
       has_measurement_unit:
-#         range: string
         required: false
+    broad_mappings:
+    - schema:QuantitativeValue
+    comments:
+    - Generic utility class for representing age values
+    - Supports both point values and ranges via schema:QuantitativeValue
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.1"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Generic utility class for temporal measurement
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/Agenda.yaml

@@ -1,7 +1,6 @@
 id: https://nde.nl/ontology/hc/class/Agenda
 name: Agenda
 title: Agenda
-description: A strategic agenda or plan.
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
@@ -14,11 +13,69 @@ imports:
 classes:
   Agenda:
     class_uri: schema:Action
-    description: Agenda.
+    description: >-
+      Ordered list of items to be addressed or accomplished within a specific
+      timeframe, typically used for meetings, events, or organizational planning.
+    alt_descriptions:
+      nl: >-
+        Geordende lijst van onderwerpen die binnen een specifiek tijdsbestek
+        aan bod moeten komen of gerealiseerd moeten worden, typisch gebruikt
+        voor vergaderingen, evenementen of organisatorische planning.
+      de: >-
+        Geordnete Liste von Punkten, die innerhalb eines bestimmten Zeitrahmens
+        behandelt oder erledigt werden sollen, typischerweise verwendet fuer
+        Sitzungen, Veranstaltungen oder organisatorische Planung.
+      fr: >-
+        Liste ordonnee d'elements a traiter ou a accomplir dans un delai
+        specifique, generalement utilisee pour les reunions, evenements ou
+        la planification organisationnelle.
+      es: >-
+        Lista ordenada de temas a tratar o realizar dentro de un plazo
+        especifico, tipicamente utilizada para reuniones, eventos o planificacion
+        organizativa.
+      ar: >-
+        قائمة مرتبة من البنود التي يجب معالجتها أو إنجازها ضمن إطار زمني
+        محدد، تُستخدم عادةً للاجتماعات أو الفعاليات أو التخطيط المؤسسي.
+      id: >-
+        Daftar terurut item yang akan dibahas atau diselesaikan dalam jangka
+        waktu tertentu, biasanya digunakan untuk rapat, acara, atau perencanaan
+        organisasi.
+      zh: >-
+        在特定时间范围内要处理或完成的有序事项列表，通常用于会议、活动或组织规划。
+    examples:
+    - value:
+        has_label: Board Meeting Agenda
+        has_description: Quarterly review and budget approval
+      description: An agenda for a quarterly board meeting
+    structured_aliases:
+    - literal_form: agenda
+      in_language: nl
+    - literal_form: Tagesordnung
+      in_language: de
+    - literal_form: ordre du jour
+      in_language: fr
+    - literal_form: orden del dia
+      in_language: es
+    - literal_form: جدول أعمال
+      in_language: ar
+    - literal_form: agenda
+      in_language: id
+    - literal_form: 议程
+      in_language: zh
+    keywords:
+    - meeting
+    - planning
+    - schedule
+    - items
+    - organizational
+    broad_mappings:
+    - schema:Action
     slots:
     - has_label
     - has_description
+    comments:
+    - Generic utility class for representing planned activities or schedules
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.1"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Generic utility class for planning
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/Agent.yaml

@@ -17,17 +17,78 @@ imports:
 classes:
   Agent:
     class_uri: prov:Agent
-    description: "An agent (person, organization, or software) that performs actions.\n\
+    description: >-
-      \n**RULE 53 MIGRATION**:\nReplaces simple string slots with a structured agent\
+      Entity that bears responsibility for an activity or action, encompassing
-      \ model:\n- `acquired_by` → Agent (this class)\n- Supports typed agents\
+      persons, organizations, groups, or software systems that can act with
-      \ (person, organization, software)\n\n**USAGE**:\n```yaml\nacquired_by:\n\
+      intent or perform operations within heritage contexts.
-      \  - agent_name: \"Dr. Jane Smith\"\n    agent_type: person\n    identified_by:\n\
+    alt_descriptions:
-      \      - identifier_scheme: ORCID\n        identifier_value: \"0000-0001-2345-6789\"\
+      nl: >-
-      \n```\n\n**Ontological Alignment**:\n- **Primary** (`class_uri`): `prov:Agent`\
+        Entiteit die verantwoordelijk is voor een activiteit of handeling,
-      \ - PROV-O agent\n- **Close**: `foaf:Agent` - FOAF agent\n- **Close**: `schema:Person`\
+        omvattende personen, organisaties, groepen of softwaresystemen die met
-      \ / `schema:Organization` - Schema.org agents\n- **Close**: `dcterms:Agent`\
+        opzet kunnen handelen of bewerkingen kunnen uitvoeren binnen
-      \ - Dublin Core agent\n\n**Use Cases**:\n- Specimen collectors (field biologists)\n\
+        erfgoedcontexten.
-      - Artwork donors/sellers\n- Archive depositors\n- Record creators\n"
+      de: >-
+        Entitaet, die Verantwortung fuer eine Aktivitaet oder Handlung traegt,
+        einschliesslich Personen, Organisationen, Gruppen oder Softwaresysteme,
+        die absichtlich handeln oder Operationen in Heritage-Kontexten
+        durchfuehren koennen.
+      fr: >-
+        Entite responsable d'une activite ou d'une action, englobant les
+        personnes, organisations, groupes ou systemes logiciels capables d'agir
+        avec intention ou d'effectuer des operations dans les contextes
+        patrimoniaux.
+      es: >-
+        Entidad responsable de una actividad o accion, que abarca personas,
+        organizaciones, grupos o sistemas de software que pueden actuar con
+        intencion o realizar operaciones en contextos patrimoniales.
+      ar: >-
+        كيان يتحمل مسؤولية نشاط أو إجراء، يشمل الأشخاص والمنظمات والمجموعات
+        أو أنظمة البرمجيات التي يمكنها التصرف بقصد أو تنفيذ عمليات في
+        السياقات التراثية.
+      id: >-
+        Entitas yang bertanggung jawab atas aktivitas atau tindakan, mencakup
+        orang, organisasi, kelompok, atau sistem perangkat lunak yang dapat
+        bertindak dengan sengaja atau melakukan operasi dalam konteks warisan.
+      zh: >-
+        承担活动或行动责任的实体，包括在遗产背景下可以有目的地行动或执行操作
+        的人员、组织、团体或软件系统。
+    examples:
+    - value:
+        has_name: Dr. Jane Smith
+        has_type: hc:PersonAgent
+        identified_by:
+        - identifier_scheme: ORCID
+          identifier_value: "0000-0001-2345-6789"
+      description: A researcher agent with ORCID identifier
+    - value:
+        has_name: Koninklijke Bibliotheek
+        has_type: hc:OrganizationAgent
+        identified_by:
+        - identifier_scheme: ISIL
+          identifier_value: "NL-LeKB"
+      description: An organization agent with ISIL identifier
+    structured_aliases:
+    - literal_form: agent
+      in_language: nl
+    - literal_form: Akteur
+      in_language: de
+    - literal_form: agent
+      in_language: fr
+    - literal_form: agente
+      in_language: es
+    - literal_form: وكيل
+      in_language: ar
+    - literal_form: agen
+      in_language: id
+    - literal_form: 代理者
+      in_language: zh
+    keywords:
+    - actor
+    - person
+    - organization
+    - software
+    - responsibility
+    - provenance
     exact_mappings:
     - prov:Agent
     close_mappings:
@@ -42,31 +103,18 @@ classes:
     - identified_by
     slot_usage:
       has_name:
-#         range: string # uriorcurie
         required: false
       has_type:
-#         range: string # uriorcurie
         required: false
       identified_by:
-#         range: string # uriorcurie
         multivalued: true
         required: false
-    annotations:
-      specificity_score: '0.25'
-      specificity_rationale: Broadly applicable - agents appear across all heritage
-        contexts.
-      template_specificity: '{"archive_search": 0.30, "museum_search": 0.30, "library_search":
-        0.30, "collection_discovery": 0.40, "person_research": 0.60, "location_browse":
-        0.15, "identifier_lookup": 0.35, "organizational_change": 0.25, "digital_platform":
-        0.20, "general_heritage": 0.25}'
-      custodian_types: '[''*'']'
-    examples:
-    - value: null
-    - value: null
-    - value:
-        identified_by:
-        - identifier_scheme: ISIL
     comments:
-    - Created per slot_fixes.yaml migration (2026-01-22)
+    - Replaces simple string slots with structured agent model
-    - 'RULE 53: Replaces collector string slot with structured model'
+    - Supports typed agents (person, organization, software, group)
-    - Generic agent class for persons, organizations, and software
+    - Fundamental class for provenance tracking in heritage contexts
+    annotations:
+      specificity_score: "0.25"
+      specificity_rationale: Broadly applicable - agents appear across all heritage contexts
+      template_specificity: '{"archive_search": 0.30, "museum_search": 0.30, "library_search": 0.30, "collection_discovery": 0.40, "person_research": 0.60, "location_browse": 0.15, "identifier_lookup": 0.35, "organizational_change": 0.25, "digital_platform": 0.20, "general_heritage": 0.25}'
+      custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/AgentType.yaml

@@ -1,10 +1,11 @@
 id: https://nde.nl/ontology/hc/class/AgentType
 name: AgentType
-title: Agent Type Abstract Class
+title: Agent Type
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
   skos: http://www.w3.org/2004/02/skos/core#
+  crm: http://www.cidoc-crm.org/cidoc-crm/
 default_prefix: hc
 imports:
   - linkml:types
@@ -14,26 +15,57 @@ imports:
 classes:
   AgentType:
     class_uri: skos:Concept
-    description: 'Abstract base class for agent types classification.
+    description: >-
-
+      Abstract classification category for categorizing agents according to
-      Provides a taxonomy for different types of agents (e.g., Person, Organization, SoftwareAgent).
+      their nature, such as persons, organizations, software systems, or
-
+      informal groups. Serves as a taxonomy foundation for agent typing.
-      '
+    alt_descriptions:
+      nl: >-
+        Abstracte classificatiecategorie voor het categoriseren van agenten
+        volgens hun aard, zoals personen, organisaties, softwaresystemen of
+        informele groepen. Dient als taxonomiefundament voor agenttypering.
+      de: >-
+        Abstrakte Klassifikationskategorie zur Kategorisierung von Akteuren nach
+        ihrer Art, wie Personen, Organisationen, Softwaresysteme oder informelle
+        Gruppen. Dient als taxonomische Grundlage fuer die Akteurtypisierung.
+      fr: >-
+        Categorie de classification abstraite pour categoriser les agents selon
+        leur nature, telle que personnes, organisations, systemes logiciels ou
+        groupes informels. Sert de fondement taxonomique pour le typage des
+        agents.
+      es: >-
+        Categoria de clasificacion abstracta para categorizar agentes segun su
+        naturaleza, como personas, organizaciones, sistemas de software o grupos
+        informales. Sirve como base taxonomica para la tipificacion de agentes.
+      ar: >-
+        فئة تصنيف مجردة لتصنيف الوكلاء حسب طبيعتهم، مثل الأشخاص أو المنظمات
+        أو أنظمة البرمجيات أو المجموعات غير الرسمية. تعمل كأساس تصنيفي
+        لنوع الوكيل.
+      id: >-
+        Kategori klasifikasi abstrak untuk mengkategorikan agen berdasarkan
+        sifatnya, seperti orang, organisasi, sistem perangkat lunak, atau
+        kelompok informal. Berfungsi sebagai dasar taksonomi untuk pengetikan
+        agen.
+      zh: >-
+        用于根据性质（如人员、组织、软件系统或非正式团体）对代理者进行分类的
+        抽象分类类别。作为代理者类型划分的分类学基础。
     abstract: true
-    exact_mappings:
+    broad_mappings:
     - skos:Concept
+    - crm:E55_Type
     slots:
     - has_label
     - has_code
     - has_description
     slot_usage:
       has_code:
-#         range: string
         required: true
       has_label:
-#         range: string
         required: false
+    comments:
+    - Abstract base class - do not instantiate directly
+    - Use concrete subclasses from AgentTypes.yaml
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.15"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Abstract classification for agent categorization
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/AgentTypes.yaml

@@ -1,48 +1,268 @@
 id: https://nde.nl/ontology/hc/class/AgentTypes
 name: agent_types_classes
 title: Agent Types Classes
-description: 'Concrete subclasses for AgentType taxonomy.
+description: >-
-
+  Concrete subclasses for AgentType taxonomy, providing specific categories
-  Follows Rule 0b Type/Types naming pattern.
+  for classifying agents by their organizational or operational nature.
-
-  '
 imports:
   - ./AgentType
   - linkml:types
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
+  crm: http://www.cidoc-crm.org/cidoc-crm/
+  schema: http://schema.org/
+  prov: http://www.w3.org/ns/prov#
 default_prefix: hc
 classes:
   PersonAgent:
     is_a: AgentType
     class_uri: hc:PersonAgent
-    description: Agent type for natural persons.
+    description: >-
-    annotations:
+      Agent type representing a natural person who performs actions or holds
-      specificity_score: 0.1
+      responsibility within heritage contexts, such as researchers, donors,
-      specificity_rationale: Generic utility class/slot created during migration
+      collectors, or staff members.
-      custodian_types: '[''*'']'
+    alt_descriptions:
+      nl: >-
+        Agenttype dat een natuurlijk persoon vertegenwoordigt die handelingen
+        verricht of verantwoordelijkheid draagt binnen erfgoedcontexten, zoals
+        onderzoekers, donateurs, verzamelaars of medewerkers.
+      de: >-
+        Akteurtyp, der eine natuerliche Person repraesentiert, die in
+        Heritage-Kontexten handelt oder Verantwortung traegt, wie Forscher,
+        Spoender, Sammler oder Mitarbeiter.
+      fr: >-
+        Type d'agent representant une personne physique qui effectue des actions
+        ou assume des responsabilites dans les contextes patrimoniaux, comme les
+        chercheurs, donateurs, collectionneurs ou membres du personnel.
+      es: >-
+        Tipo de agente que representa a una persona natural que realiza acciones
+        o tiene responsabilidades en contextos patrimoniales, como
+        investigadores, donantes, coleccionistas o personal.
+      ar: >-
+        نوع الوكيل الذي يمثل شخصًا طبيعيًا يقوم بإجراءات أو يتحمل مسؤولية
+        في السياقات التراثية، مثل الباحثين أو المتبرعين أو الجامعين أو
+        الموظفين.
+      id: >-
+        Jenis agen yang mewakili orang alami yang melakukan tindakan atau
+        memikul tanggung jawab dalam konteks warisan, seperti peneliti,
+        donor, kolektor, atau staf.
+      zh: >-
+        代表在遗产背景下执行行动或承担责任的自然人的代理者类型，如研究人员、
+        捐赠者、收藏家或工作人员。
+    structured_aliases:
+    - literal_form: persoonsagent
+      in_language: nl
+    - literal_form: Personenakteur
+      in_language: de
+    - literal_form: agent personne
+      in_language: fr
+    - literal_form: agente persona
+      in_language: es
+    - literal_form: وكيل شخصي
+      in_language: ar
+    - literal_form: agen orang
+      in_language: id
+    - literal_form: 个人代理者
+      in_language: zh
     broad_mappings:
-    - crm:E39_Actor
+    - crm:E21_Person
-    - schema:Organization
+    - schema:Person
+    - prov:Agent
+    keywords:
+    - person
+    - individual
+    - researcher
+    - donor
+    - collector
   OrganizationAgent:
     is_a: AgentType
     class_uri: hc:OrganizationAgent
-    description: Agent type for organizations.
+    description: >-
+      Agent type representing a formal organization or institution that performs
+      actions or holds responsibility within heritage contexts, such as archives,
+      libraries, museums, or government bodies.
+    alt_descriptions:
+      nl: >-
+        Agenttype dat een formele organisatie of instelling vertegenwoordigt die
+        handelingen verricht of verantwoordelijkheid draagt binnen
+        erfgoedcontexten, zoals archieven, bibliotheken, musea of
+        overheidsinstanties.
+      de: >-
+        Akteurtyp, der eine formelle Organisation oder Institution repraesentiert,
+        die in Heritage-Kontexten handelt oder Verantwortung traegt, wie Archive,
+        Bibliotheken, Museen oder Behoerden.
+      fr: >-
+        Type d'agent representant une organisation ou institution formelle qui
+        effectue des actions ou assume des responsabilites dans les contextes
+        patrimoniaux, comme les archives, bibliotheques, musees ou organismes
+        gouvernementaux.
+      es: >-
+        Tipo de agente que representa una organizacion o institucion formal que
+        realiza acciones o tiene responsabilidades en contextos patrimoniales,
+        como archivos, bibliotecas, museos u organismos gubernamentales.
+      ar: >-
+        نوع الوكيل الذي يمثل منظمة أو مؤسسة رسمية تقوم بإجراءات أو تتحمل
+        مسؤولية في السياقات التراثية، مثل الأرشيفات أو المكتبات أو
+        المتاحف أو الهيئات الحكومية.
+      id: >-
+        Jenis agen yang mewakili organisasi atau institusi formal yang melakukan
+        tindakan atau memikul tanggung jawab dalam konteks warisan, seperti
+        arsip, perpustakaan, museum, atau lembaga pemerintah.
+      zh: >-
+        代表在遗产背景下执行行动或承担责任的正式组织或机构的代理者类型，如
+        档案馆、图书馆、博物馆或政府机构。
+    structured_aliases:
+    - literal_form: organisatieagent
+      in_language: nl
+    - literal_form: Organisationsakteur
+      in_language: de
+    - literal_form: agent organisation
+      in_language: fr
+    - literal_form: agente organizacion
+      in_language: es
+    - literal_form: وكيل مؤسسي
+      in_language: ar
+    - literal_form: agen organisasi
+      in_language: id
+    - literal_form: 组织代理者
+      in_language: zh
     broad_mappings:
-    - crm:E39_Actor
+    - crm:E40_Legal_Body
     - schema:Organization
+    - prov:Agent
+    keywords:
+    - organization
+    - institution
+    - archive
+    - library
+    - museum
   SoftwareAgent:
     is_a: AgentType
     class_uri: hc:SoftwareAgent
-    description: Agent type for software agents or automated processes.
+    description: >-
+      Agent type representing a software system, automated process, or algorithm
+      that performs actions within heritage contexts, such as cataloging systems,
+      digitization workflows, or data processing pipelines.
+    alt_descriptions:
+      nl: >-
+        Agenttype dat een softwaresysteem, geautomatiseerd proces of algoritme
+        vertegenwoordigt dat handelingen verricht binnen erfgoedcontexten, zoals
+        catalogiseringssystemen, digitaliseringsworkflows of
+        dataverwerkingspijplijnen.
+      de: >-
+        Akteurtyp, der ein Softwaresystem, einen automatisierten Prozess oder
+        Algorithmus repraesentiert, der in Heritage-Kontexten handelt, wie
+        Katalogisierungssysteme, Digitalisierungsworkflows oder
+        Datenverarbeitungspipelines.
+      fr: >-
+        Type d'agent representant un systeme logiciel, un processus automatise
+        ou un algorithme qui effectue des actions dans les contextes
+        patrimoniaux, comme les systemes de catalogage, les flux de
+        numerisation ou les pipelines de traitement de donnees.
+      es: >-
+        Tipo de agente que representa un sistema de software, proceso
+        automatizado o algoritmo que realiza acciones en contextos patrimoniales,
+        como sistemas de catalogacion, flujos de digitalizacion o canalizaciones
+        de procesamiento de datos.
+      ar: >-
+        نوع الوكيل الذي يمثل نظام برمجي أو عملية آلية أو خوارزمية تقوم
+        بإجراءات في السياقات التراثية، مثل أنظمة الفهرسة أو سير عمل
+        الرقمنة أو خطوط معالجة البيانات.
+      id: >-
+        Jenis agen yang mewakili sistem perangkat lunak, proses otomatis, atau
+        algoritma yang melakukan tindakan dalam konteks warisan, seperti sistem
+        katalog, alur kerja digitalisasi, atau pipeline pemrosesan data.
+      zh: >-
+        代表在遗产背景下执行操作的软件系统、自动化流程或算法的代理者类型，如
+        编目系统、数字化工作流或数据处理管道。
+    structured_aliases:
+    - literal_form: softwareagent
+      in_language: nl
+    - literal_form: Softwareakteur
+      in_language: de
+    - literal_form: agent logiciel
+      in_language: fr
+    - literal_form: agente software
+      in_language: es
+    - literal_form: وكيل برمجي
+      in_language: ar
+    - literal_form: agen perangkat lunak
+      in_language: id
+    - literal_form: 软件代理者
+      in_language: zh
     broad_mappings:
-    - crm:E39_Actor
+    - prov:SoftwareAgent
-    - schema:Organization
+    - schema:SoftwareApplication
+    keywords:
+    - software
+    - automated
+    - algorithm
+    - system
+    - process
   GroupAgent:
     is_a: AgentType
     class_uri: hc:GroupAgent
-    description: Agent type for informal groups or collectives.
+    description: >-
+      Agent type representing an informal group, collective, or ad-hoc assembly
+      of persons that performs actions within heritage contexts without formal
+      organizational structure, such as research teams, community groups, or
+      project collaborations.
+    alt_descriptions:
+      nl: >-
+        Agenttype dat een informele groep, collectief of ad-hocvergadering van
+        personen vertegenwoordigt die handelingen verricht binnen
+        erfgoedcontexten zonder formele organisatiestructuur, zoals
+        onderzoeksteams, gemeenschapsgroepen of projectcollaboraties.
+      de: >-
+        Akteurtyp, der eine informelle Gruppe, ein Kollektiv oder eine
+        Ad-hoc-Versammlung von Personen repraesentiert, die in Heritage-Kontexten
+        ohne formelle Organisationsstruktur handelt, wie Forschungsteams,
+        Gemeinschaftsgruppen oder Projektzusammenarbeiten.
+      fr: >-
+        Type d'agent representant un groupe informel, un collectif ou une
+        assemblee ad hoc de personnes qui effectue des actions dans les contextes
+        patrimoniaux sans structure organisationnelle formelle, comme les equipes
+        de recherche, les groupes communautaires ou les collaborations de projet.
+      es: >-
+        Tipo de agente que representa un grupo informal, colectivo o asamblea
+        ad hoc de personas que realiza acciones en contextos patrimoniales sin
+        estructura organizativa formal, como equipos de investigacion, grupos
+        comunitarios o colaboraciones de proyectos.
+      ar: >-
+        نوع الوكيل الذي يمثل مجموعة غير رسمية أو تجمع أو جمعية مؤقتة من
+        الأشخاص تقوم بإجراءات في السياقات التراثية بدون هيكل تنظيمي رسمي،
+        مثل فرق البحث أو مجموعات المجتمع أو تعاونات المشاريع.
+      id: >-
+        Jenis agen yang mewakili kelompok informal, kolektif, atau perkumpulan
+        ad hoc orang yang melakukan tindakan dalam konteks warisan tanpa
+        struktur organisasi formal, seperti tim penelitian, kelompok komunitas,
+        atau kolaborasi proyek.
+      zh: >-
+        代表在遗产背景下执行操作的非正式团体、集体或临时人员集会的代理者类型，
+        无正式组织结构，如研究团队、社区团体或项目协作。
+    structured_aliases:
+    - literal_form: groepsagent
+      in_language: nl
+    - literal_form: Gruppenakteur
+      in_language: de
+    - literal_form: agent groupe
+      in_language: fr
+    - literal_form: agente grupo
+      in_language: es
+    - literal_form: وكيل جماعي
+      in_language: ar
+    - literal_form: agen kelompok
+      in_language: id
+    - literal_form: 团体代理者
+      in_language: zh
     broad_mappings:
-    - crm:E39_Actor
+    - crm:E74_Group
     - schema:Organization
+    - prov:Agent
+    keywords:
+    - group
+    - collective
+    - team
+    - informal
+    - collaboration

schemas/20251121/linkml/modules/classes/Agreement.yaml

@@ -1,6 +1,6 @@
 id: https://nde.nl/ontology/hc/class/Agreement
 name: Agreement
-title: Agreement Class
+title: Agreement
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
@@ -8,10 +8,6 @@ prefixes:
   dcterms: http://purl.org/dc/terms/
   prov: http://www.w3.org/ns/prov#
   crm: http://www.cidoc-crm.org/cidoc-crm/
-  skos: http://www.w3.org/2004/02/skos/core#
-  rdfs: http://www.w3.org/2000/01/rdf-schema#
-  org: http://www.w3.org/ns/org#
-  xsd: http://www.w3.org/2001/XMLSchema#
 default_prefix: hc
 imports:
   - linkml:types
@@ -22,23 +18,74 @@ imports:
 classes:
   Agreement:
     class_uri: schema:Contract
-    description: 'A formal agreement, contract, or treaty between parties.
+    description: >-
-
+      Formal arrangement between two or more parties establishing mutual
-
+      obligations, rights, or expectations, typically documented in writing
-      **Examples**:
+      and enforceable within heritage institutional contexts.
-
+    alt_descriptions:
-      - Loan Agreement
+      nl: >-
-
+        Formele regeling tussen twee of meer partijen die wederzijdse
-      - Service Agreement
+        verplichtingen, rechten of verwachtingen vastlegt, typisch schriftelijk
-
+        gedocumenteerd en afdwingbaar binnen erfgoedinstellingen.
-      - Memorandum of Understanding
+      de: >-
-
+        Formelle Vereinbarung zwischen zwei oder mehr Parteien, die gegenseitige
-
+        Verpflichtungen, Rechte oder Erwartungen festlegt, typischerweise
-      **Ontological Alignment**:
+        schriftlich dokumentiert und in Heritage-Institutionen durchsetzbar.
-
+      fr: >-
-      - `schema:Contract`: A generic agreement.
+        Arrangement formel entre deux ou plusieurs parties etablissant des
-
+        obligations, droits ou attentes mutuels, generalement documente par
-      '
+        ecrit et applicable dans les contextes institutionnels patrimoniaux.
+      es: >-
+        Acuerdo formal entre dos o mas partes que establece obligaciones,
+        derechos o expectativas mutuas, tipicamente documentado por escrito
+        y aplicable en contextos institucionales patrimoniales.
+      ar: >-
+        ترتيب رسمي بين طرفين أو أكثر يحدد التزامات أو حقوق أو توقعات
+        متبادلة، موثق عادةً كتابيًا وقابل للإنفاذ في السياقات المؤسسية
+        التراثية.
+      id: >-
+        Pengaturan formal antara dua pihak atau lebih yang menetapkan kewajiban,
+        hak, atau harapan timbal balik, biasanya didokumentasikan secara tertulis
+        dan dapat diberlakukan dalam konteks lembaga warisan.
+      zh: >-
+        两方或多方之间建立相互义务、权利或期望的正式安排，通常以书面形式记录，
+        并在遗产机构背景下可执行。
+    examples:
+    - value:
+        has_label: Loan Agreement
+        has_description: Outgoing loan of collection items to partner museum
+        signed_on: "2024-01-15"
+      description: A loan agreement for collection items
+    - value:
+        has_label: Memorandum of Understanding
+        has_description: Collaborative research partnership agreement
+      description: A partnership MOU
+    structured_aliases:
+    - literal_form: overeenkomst
+      in_language: nl
+    - literal_form: Vereinbarung
+      in_language: de
+    - literal_form: accord
+      in_language: fr
+    - literal_form: acuerdo
+      in_language: es
+    - literal_form: اتفاقية
+      in_language: ar
+    - literal_form: perjanjian
+      in_language: id
+    - literal_form: 协议
+      in_language: zh
+    keywords:
+    - contract
+    - legal
+    - loan
+    - partnership
+    - memorandum
+    - formal
+    exact_mappings:
+    - schema:Contract
+    broad_mappings:
+    - schema:Thing
     slots:
     - has_label
     - has_description
@@ -46,9 +93,15 @@ classes:
     - temporal_extent
     slot_usage:
       has_label:
+        required: true
       signed_on:
+        required: false
       temporal_extent:
+        required: false
+    comments:
+    - Used for loans, partnerships, service agreements, and MOUs
+    - May be linked to acquisition, lending, or collaborative activities
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.2"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Applicable to institutional agreements and contracts
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/AirChanges.yaml

@@ -1,10 +1,11 @@
 id: https://nde.nl/ontology/hc/class/AirChanges
 name: AirChanges
-title: Air Changes Class
+title: Air Changes
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
   schema: http://schema.org/
+  wd: http://www.wikidata.org/entity/
 default_prefix: hc
 imports:
   - linkml:types
@@ -13,14 +14,76 @@ imports:
 classes:
   AirChanges:
     class_uri: schema:QuantitativeValue
-    description: 'Represents the rate of air changes in a space.
+    description: >-
-
+      Measurement of the rate at which air within an enclosed space is replaced
-
+      with fresh air, expressed as air changes per hour (ACH) or per minute,
-      **Ontological Alignment**:
+      critical for environmental control in storage and exhibition spaces.
-
+    alt_descriptions:
-      - `schema:QuantitativeValue`: Allows specifying value and unit.
+      nl: >-
-
+        Meting van de snelheid waarmee lucht in een afgesloten ruimte wordt
-      '
+        vervangen door verse lucht, uitgedrukt als luchtveranderingen per uur
+        of per minuut, cruciaal voor milieubeheersing in opslag- en
+        tentoonstellingsruimtes.
+      de: >-
+        Messung der Rate, mit der Luft in einem geschlossenen Raum durch
+        Frischluft ersetzt wird, ausgedrueckt als Luftwechsel pro Stunde oder
+        Minute, kritisch fuer die Umweltkontrolle in Lager- und
+        Ausstellungsräumen.
+      fr: >-
+        Mesure du taux auquel l'air dans un espace clos est remplace par de
+        l'air frais, exprimee en renouvellements d'air par heure ou par minute,
+        essentielle pour le controle environnemental des espaces de stockage et
+        d'exposition.
+      es: >-
+        Medicion de la tasa a la que el aire en un espacio cerrado es reemplazado
+        por aire fresco, expresada como cambios de aire por hora o por minuto,
+        critica para el control ambiental en espacios de almacenamiento y
+        exposicion.
+      ar: >-
+        قياس معدل استبدال الهواء في مساحة مغلقة بهواء نقي، معبرًا عنه
+        بتغييرات الهواء في الساعة أو الدقيقة، وهو أمر بالغ الأهمية للتحكم
+        البيئي في مساحات التخزين والعرض.
+      id: >-
+        Pengukuran tingkat pergantian udara dalam ruang tertutup dengan udara
+        segar, dinyatakan sebagai pergantian udara per jam atau per menit,
+        penting untuk kontrol lingkungan di ruang penyimpanan dan pameran.
+      zh: >-
+        衡量封闭空间内空气被新鲜空气替换的速率，以每小时或每分钟换气次数表示，
+        对于存储和展示空间的环境控制至关重要。
+    examples:
+    - value:
+        has_quantity: 4
+        has_measurement_unit: "ACH"
+      description: Four air changes per hour for storage facility
+    - value:
+        has_quantity: 6
+        has_measurement_unit: "ACH"
+      description: Six air changes per hour for exhibition space
+    structured_aliases:
+    - literal_form: luchtveranderingen
+      in_language: nl
+    - literal_form: Luftwechsel
+      in_language: de
+    - literal_form: renouvellement d'air
+      in_language: fr
+    - literal_form: cambios de aire
+      in_language: es
+    - literal_form: تغييرات الهواء
+      in_language: ar
+    - literal_form: pergantian udara
+      in_language: id
+    - literal_form: 换气次数
+      in_language: zh
+    keywords:
+    - ventilation
+    - HVAC
+    - environmental control
+    - storage
+    - exhibition
+    - air quality
+    broad_mappings:
+    - schema:QuantitativeValue
+    - wd:Q2299838
     slots:
     - has_quantity
     - has_measurement_unit
@@ -29,9 +92,11 @@ classes:
         range: float
         required: true
       has_measurement_unit:
-#         range: string
         required: true
+    comments:
+    - Critical parameter for collections preservation
+    - Higher ACH values indicate better ventilation rates
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.2"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Specific environmental control measurement
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/Alignment.yaml

@@ -1,12 +1,10 @@
 id: https://nde.nl/ontology/hc/class/Alignment
 name: alignment_class
-title: Alignment Class
+title: Alignment
-description: 'Represents positioning or alignment information for content elements.
+description: >-
-  **USE CASES**:
+  Positioning or arrangement specification for visual elements within content
-  - Caption/subtitle positioning (top, bottom, left, right)
+  layouts, supporting caption placement, text arrangement, and element
-  - Text alignment within containers
+  positioning in digital heritage presentations.
-  - Visual element placement in layouts
-  '
 imports:
   - linkml:types
   - ../slots/has_alignment
@@ -20,16 +18,81 @@ default_prefix: hc
 classes:
   Alignment:
     class_uri: hc:Alignment
-    description: 'Positioning or alignment information for content elements.
+    description: >-
-      Captures alignment, position values, and units.
+      Specification of positioning or arrangement for content elements within
-      '
+      display contexts, capturing alignment direction, position values, and
+      measurement units for precise layout control in digital presentations.
+    alt_descriptions:
+      nl: >-
+        Specificatie van positionering of rangschikking van elementen in
+        weergavecontexten, vastleggend uitlijningsrichting, positiewaarden en
+        meeteenheden voor nauwkeurige lay-outbeheersing in digitale
+        presentaties.
+      de: >-
+        Spezifikation der Positionierung oder Anordnung von Inhaltselementen in
+        Anzeigekontexten, die Ausrichtungsrichtung, Positionswerte und
+        Masseinheiten fuer praezise Layout-Kontrolle in digitalen Praesentationen
+        erfasst.
+      fr: >-
+        Specification du positionnement ou de l'arrangement d'elements de
+        contenu dans des contextes d'affichage, capturant la direction de
+        l'alignement, les valeurs de position et les unites de mesure pour un
+        controle precis de la mise en page dans les presentations numeriques.
+      es: >-
+        Especificacion del posicionamiento o disposicion de elementos de
+        contenido en contextos de visualizacion, capturando la direccion de
+        alineacion, valores de posicion y unidades de medida para un control
+        preciso del diseno en presentaciones digitales.
+      ar: >-
+        مواصفات التموضع أو الترتيب لعناصر المحتوى في سياقات العرض، مع
+        تسجيل اتجاه المحاذاة وقيم الموضع ووحدات القياس للتحكم الدقيق
+        في التخطيط في العروض الرقمية.
+      id: >-
+        Spesifikasi pemosisian atau pengaturan elemen konten dalam konteks
+        tampilan, menangkap arah perataan, nilai posisi, dan satuan pengukuran
+        untuk kontrol tata letak yang presisi dalam presentasi digital.
+      zh: >-
+        在显示上下文中对内容元素的定位或排列规范，捕捉对齐方向、位置值和
+        度量单位，用于数字演示中的精确布局控制。
+    examples:
+    - value:
+        has_alignment: center
+        has_value: "50"
+        has_measurement_unit: "%"
+      description: Center-aligned element at 50% horizontal position
+    - value:
+        has_alignment:
+        - bottom
+        - right
+      description: Caption positioned at bottom-right
+    structured_aliases:
+    - literal_form: uitlijning
+      in_language: nl
+    - literal_form: Ausrichtung
+      in_language: de
+    - literal_form: alignement
+      in_language: fr
+    - literal_form: alineacion
+      in_language: es
+    - literal_form: محاذاة
+      in_language: ar
+    - literal_form: perataan
+      in_language: id
+    - literal_form: 对齐
+      in_language: zh
+    keywords:
+    - position
+    - layout
+    - caption
+    - text alignment
+    - visual
+    - display
     slots:
     - has_alignment
     - has_value
     - has_measurement_unit
     slot_usage:
       has_alignment:
-#         range: string
         multivalued: true
         examples:
         - value: center
@@ -37,16 +100,17 @@ classes:
         - value: bottom
         - value: middle
       has_value:
-#         range: string
         examples:
-        - value: '10'
+        - value: "10"
         - value: default
       has_measurement_unit:
-#         range: string
         examples:
         - value: px
-        - value: '%'
+        - value: "%"
+    comments:
+    - Generic utility class for layout positioning
+    - Supports multi-value alignment for combined directions
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.1"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Generic utility class for layout positioning
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/AllocationAgency.yaml

@@ -1,12 +1,13 @@
 id: https://nde.nl/ontology/hc/class/AllocationAgency
 name: allocation_agency
-title: Allocation Agency Class
+title: Allocation Agency
 prefixes:
   linkml: https://w3id.org/linkml/
   schema: http://schema.org/
   org: http://www.w3.org/ns/org#
   gleif_base: https://www.gleif.org/ontology/Base/
   hc: https://nde.nl/ontology/hc/
+default_prefix: hc
 imports:
   - linkml:types
   - ../enums/AllocationDomainEnum
@@ -16,41 +17,90 @@ imports:
 classes:
   AllocationAgency:
     class_uri: org:FormalOrganization
-    description: "An organization that allocates identifiers within a specific geographic\
+    description: >-
-      \ area \nand/or domain of heritage institutions.\n\n**Key Distinction from RegistrationAuthority:**\n\
+      Organization authorized to allocate identifiers within a specific
-      \n- **RegistrationAuthority**: Maintains the GLOBAL registry for a standard\n\
+      geographic area and/or domain of heritage institutions, distinguished
-      \  - Example: Danish Agency for Culture and Palaces maintains global ISIL registry\n\
+      from registration authorities that maintain global registries for
-      \  - Example: ISNI International Agency (WIPO) maintains global ISNI database\n\
+      identifier standards.
-      \n- **AllocationAgency**: Allocates identifiers LOCALLY within constraints\n\
+    alt_descriptions:
-      \  - Example: Koninklijke Bibliotheek allocates ISIL for Dutch public libraries\n\
+      nl: >-
-      \  - Example: OCLC allocates ISIL for Dutch academic libraries\n  - Example:\
+        Organisatie die bevoegd is om identifiers toe te wijzen binnen een
-      \ Nationaal Archief allocates ISIL for Dutch archives\n\n**Multi-Dimensional\
+        specifiek geografisch gebied en/of domein van erfgoedinstellingen,
-      \ Scope:**\n\nAllocationAgencies have both:\n1. **Geographic scope**: Which\
+        te onderscheiden van registratieautoriteiten die wereldwijde registers
-      \ country/region they serve\n2. **Domain scope**: Which types of institutions\
+        bijhouden voor identifierstandaarden.
-      \ they serve\n\nThis allows multiple agencies per country, each serving different\
+      de: >-
-      \ domains:\n- NL public libraries → KB\n- NL academic libraries → OCLC\n- NL\
+        Organisation, die berechtigt ist, Kennungen innerhalb eines bestimmten
-      \ archives → Nationaal Archief\n\n**Relationship to Standard:**\n\nAn AllocationAgency\
+        geografischen Bereichs und/oder Bereichs von Heritage-Institutionen
-      \ allocates for one or more Standards:\n- AllocationAgency.allocates_for → Standard[]\n\
+        zuzuweisen, unterschieden von Registrierungsbehoerden, die globale
-      - Standard can have multiple AllocationAgencies (one per country/domain)\n\n\
+        Register fuer Kennungsstandards pflegen.
-      **Examples:**\n\n| Agency | Country | Domain | Standard |\n|--------|---------|--------|----------|\n\
+      fr: >-
-      | Koninklijke Bibliotheek | NL | Public libraries | ISIL |\n| OCLC | NL | Academic\
+        Organisation autorisee a attribuer des identifiants dans une zone
-      \ libraries | ISIL |\n| Nationaal Archief | NL | Archives | ISIL |\n| British\
+        geographique specifique et/ou un domaine d'institutions patrimoniales,
-      \ Library | GB | All | ISIL |\n| Library of Congress | US | All | ISIL |\n|\
+        distinguee des autorites d'enregistrement qui maintiennent des registres
-      \ OCLC | Global | Academic | VIAF |\n| Deutsche Nationalbibliothek | DE | All\
+        mondiaux pour les normes d'identifiants.
-      \ | ISNI |\n\n**Ontology Alignment:**\n\n- org:FormalOrganization - W3C Organization\
+      es: >-
-      \ Ontology\n- Extends gleif_base:RegistrationAuthority concept (but for allocation,\
+        Organizacion autorizada para asignar identificadores dentro de un area
-      \ not registration)\n"
+        geografica especifica y/o dominio de instituciones patrimoniales,
-    exact_mappings:
+        distinguible de las autoridades de registro que mantienen registros
+        globales para estandares de identificadores.
+      ar: >-
+        منظمة مخولة لتخصيص المعرفات داخل منطقة جغرافية محددة و/أو مجال
+        المؤسسات التراثية، تتميز عن سلطات التسجيل التي تحافظ على سجلات
+        عالمية لمعايير المعرفات.
+      id: >-
+        Organisasi yang berwenang mengalokasikan pengidentifikasi dalam area
+        geografis tertentu dan/atau domain lembaga warisan, dibedakan dari
+        otoritas pendaftaran yang memelihara registri global untuk standar
+        pengidentifikasi.
+      zh: >-
+        被授权在特定地理区域和/或遗产机构领域内分配标识符的组织，区别于维护
+        标识符标准全球注册表的注册机构。
+    examples:
+    - value:
+        has_name: Koninklijke Bibliotheek
+        has_score: 1.0
+      description: KB allocates ISIL for Dutch public libraries
+    - value:
+        has_name: Nationaal Archief
+        has_score: 1.0
+      description: Nationaal Archief allocates ISIL for Dutch archives
+    structured_aliases:
+    - literal_form: toewijzingsagentschap
+      in_language: nl
+    - literal_form: Zuweisungsstelle
+      in_language: de
+    - literal_form: agence d'allocation
+      in_language: fr
+    - literal_form: agencia de asignacion
+      in_language: es
+    - literal_form: وكالة التخصيص
+      in_language: ar
+    - literal_form: lembaga alokasi
+      in_language: id
+    - literal_form: 分配机构
+      in_language: zh
+    keywords:
+    - identifier allocation
+    - ISIL
+    - ISNI
+    - VIAF
+    - registration
+    - authority
+    broad_mappings:
     - org:FormalOrganization
+    - schema:Organization
     close_mappings:
     - gleif_base:RegistrationAuthority
-    - schema:Organization
     slots:
     - has_score
     - has_name
     - has_label
     - current
+    comments:
+    - AllocationAgency allocates LOCALLY within geographic/domain constraints
+    - RegistrationAuthority maintains GLOBAL registry for a standard
+    - Multiple AllocationAgencies may serve different domains within one country
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.25"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Specific to identifier allocation within heritage domain
-      custodian_types: '[''*'']'
+      custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/AllocationEvent.yaml

@@ -1,6 +1,6 @@
 id: https://nde.nl/ontology/hc/class/AllocationEvent
 name: AllocationEvent
-title: Allocation Event Class
+title: Allocation Event
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
@@ -13,20 +13,73 @@ imports:
 classes:
   AllocationEvent:
     class_uri: prov:Activity
-    description: 'An event representing the allocation of an identifier.
+    description: >-
-
+      Occurrence of assigning an identifier to an entity by an allocation
-
+      agency, capturing when and within what timeframe the allocation took
-      **Ontological Alignment**:
+      place.
-
+    alt_descriptions:
-      - `prov:Activity`: An activity that occurred over a period of time and acted upon or with entities.
+      nl: >-
-
+        Gebeurtenis waarbij een identifier aan een entiteit wordt toegewezen
-      '
+        door een toewijzingsagentschap, vastleggend wanneer en binnen welk
+        tijdsbestek de toewijzing plaatsvond.
+      de: >-
+        Ereignis der Zuweisung einer Kennung an eine Entitaet durch eine
+        Zuweisungsstelle, das erfasst, wann und in welchem Zeitraum die
+        Zuweisung stattfand.
+      fr: >-
+        Evenement d'attribution d'un identifiant a une entite par une agence
+        d'allocation, capturant quand et dans quel delai l'allocation a eu
+        lieu.
+      es: >-
+        Evento de asignacion de un identificador a una entidad por una agencia
+        de asignacion, capturando cuando y en que periodo de tiempo ocurrio la
+        asignacion.
+      ar: >-
+        حدث تخصيص معرف لكيان من قبل وكالة تخصيص، مع تسجيل متى وفي أي
+        إطار زمني تم التخصيص.
+      id: >-
+        Peristiwa pengalokasian pengidentifikasi ke entitas oleh lembaga
+        alokasi, mencatat kapan dan dalam jangka waktu apa alokasi terjadi.
+      zh: >-
+        由分配机构向实体分配标识符的事件，记录分配发生的时间和时限。
+    examples:
+    - value:
+        temporal_extent:
+          start_date: "2024-01-15"
+          end_date: "2024-01-15"
+      description: Allocation event on a specific date
+    structured_aliases:
+    - literal_form: toewijzingsgebeurtenis
+      in_language: nl
+    - literal_form: Zuweisungsereignis
+      in_language: de
+    - literal_form: evenement d'allocation
+      in_language: fr
+    - literal_form: evento de asignacion
+      in_language: es
+    - literal_form: حدث التخصيص
+      in_language: ar
+    - literal_form: peristiwa alokasi
+      in_language: id
+    - literal_form: 分配事件
+      in_language: zh
+    keywords:
+    - identifier assignment
+    - allocation
+    - timestamp
+    - provenance
+    broad_mappings:
+    - prov:Activity
+    - schema:Action
     slots:
     - temporal_extent
     slot_usage:
       temporal_extent:
         required: true
+    comments:
+    - Records when an identifier was officially assigned
+    - Links to AllocationAgency that performed the allocation
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.15"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Specific event type for identifier allocation
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/Alpha2Code.yaml

@@ -6,6 +6,7 @@ prefixes:
   hc: https://nde.nl/ontology/hc/
   skos: http://www.w3.org/2004/02/skos/core#
   schema: http://schema.org/
+  wd: http://www.wikidata.org/entity/
 default_prefix: hc
 imports:
   - linkml:types
@@ -13,50 +14,84 @@ imports:
 classes:
   Alpha2Code:
     class_uri: skos:Concept
-    description: 'ISO 3166-1 alpha-2 country code (two-letter code).
+    description: >-
-
+      Two-letter country code conforming to ISO 3166-1 alpha-2 standard,
-
+      providing a standardized abbreviation for countries and dependent
-      **DEFINITION**:
+      territories in international contexts.
-
+    alt_descriptions:
-
+      nl: >-
-      A two-letter country code as defined by ISO 3166-1 alpha-2 standard.
+        Tweeletterige landcode conform de ISO 3166-1 alpha-2 standaard,
-
+        die een gestandaardiseerde afkorting biedt voor landen en
-      Used for representing countries and dependent territories.
+        afhankelijke gebieden in internationale contexten.
-
+      de: >-
-
+        Zweibuchstabiger Laendercode nach ISO 3166-1 alpha-2 Standard, der
-      **EXAMPLES**:
+        eine standardisierte Abkuerzung fuer Laender und abhaengige Gebiete
-
+        in internationalen Kontexten bietet.
-      - NL = Netherlands
+      fr: >-
-
+        Code pays a deux lettres conforme a la norme ISO 3166-1 alpha-2,
-      - BE = Belgium
+        fournissant une abreviation standardisee pour les pays et territoires
-
+        dependants dans les contextes internationaux.
-      - DE = Germany
+      es: >-
-
+        Codigo de pais de dos letras conforme al estandar ISO 3166-1 alfa-2,
-      - US = United States
+        que proporciona una abreviatura estandarizada para paises y territorios
-
+        dependientes en contextos internacionales.
-
+      ar: >-
-      **ONTOLOGY ALIGNMENT**:
+        رمز بلد من حرفين يتوافق مع معيار ISO 3166-1 alpha-2، يوفر اختصارًا
-
+        موحدًا للبلدان والأقاليم التابعة في السياقات الدولية.
-      - SKOS Concept: Codes are concepts in ISO 3166-1 vocabulary
+      id: >-
-
+        Kode negara dua huruf yang sesuai dengan standar ISO 3166-1 alpha-2,
-      - Schema.org: addressCountry can use alpha-2 codes
+        memberikan singkatan terstandarisasi untuk negara dan wilayah
-
+        dependensi dalam konteks internasional.
-      '
+      zh: >-
+        符合ISO 3166-1 alpha-2标准的双字母国家代码，在国际背景下为国家和
+        属地提供标准化缩写。
+    examples:
+    - value:
+        has_code: NL
+      description: Netherlands
+    - value:
+        has_code: BE
+      description: Belgium
+    - value:
+        has_code: DE
+      description: Germany
+    structured_aliases:
+    - literal_form: alfa-2-code
+      in_language: nl
+    - literal_form: Alpha-2-Code
+      in_language: de
+    - literal_form: code alpha-2
+      in_language: fr
+    - literal_form: codigo alfa-2
+      in_language: es
+    - literal_form: رمز ألفا-2
+      in_language: ar
+    - literal_form: kode alfa-2
+      in_language: id
+    - literal_form: alpha-2代码
+      in_language: zh
+    keywords:
+    - ISO 3166
+    - country code
+    - two-letter
+    - standard
+    - geographic
+    broad_mappings:
+    - skos:Concept
+    - wd:Q42032
     slots:
     - has_code
     slot_usage:
       has_code:
-        pattern: ^[A-Z]{2}$
+        pattern: "^[A-Z]{2}$"
         required: true
         examples:
         - value: NL
         - value: BE
-    exact_mappings:
+    comments:
-    - skos:Concept
+    - ISO 3166-1 alpha-2 codes are maintained by ISO
+    - Used in ISIL identifiers and address standards
     annotations:
-      specificity_score: '0.30'
+      specificity_score: "0.30"
-      specificity_rationale: Low specificity - standard country codes used broadly.
+      specificity_rationale: Standardized country code format
       custodian_types: "['*']"
-    examples:
-    - value:
-        has_code: NL

schemas/20251121/linkml/modules/classes/Alpha3Code.yaml

@@ -6,6 +6,7 @@ prefixes:
   hc: https://nde.nl/ontology/hc/
   skos: http://www.w3.org/2004/02/skos/core#
   schema: http://schema.org/
+  wd: http://www.wikidata.org/entity/
 default_prefix: hc
 imports:
   - linkml:types
@@ -13,50 +14,85 @@ imports:
 classes:
   Alpha3Code:
     class_uri: skos:Concept
-    description: 'ISO 3166-1 alpha-3 country code (three-letter code).
+    description: >-
-
+      Three-letter country code conforming to ISO 3166-1 alpha-3 standard,
-
+      providing more recognizable abbreviations for countries and dependent
-      **DEFINITION**:
+      territories than alpha-2 codes while remaining concise.
-
+    alt_descriptions:
-
+      nl: >-
-      A three-letter country code as defined by ISO 3166-1 alpha-3 standard.
+        Drieletterige landcode conform de ISO 3166-1 alpha-3 standaard, die
-
+        herkenbaardere afkortingen biedt voor landen en afhankelijke gebieden
-      Used for representing countries and dependent territories with more
+        dan alpha-2 codes, en toch beknopt blijft.
-
+      de: >-
-      recognizable abbreviations.
+        Dreibuchstabiger Laendercode nach ISO 3166-1 alpha-3 Standard, der
-
+        erkennbarere Abkuerzungen fuer Laender und abhaengige Gebiete bietet
-
+        als Alpha-2-Codes und dabei praezise bleibt.
-      **EXAMPLES**:
+      fr: >-
-
+        Code pays a trois lettres conforme a la norme ISO 3166-1 alpha-3,
-      - NLD = Netherlands
+        fournissant des abreviations plus reconnaissables pour les pays et
-
+        territoires dependants que les codes alpha-2 tout en restant concis.
-      - BEL = Belgium
+      es: >-
-
+        Codigo de pais de tres letras conforme al estandar ISO 3166-1 alfa-3,
-      - DEU = Germany
+        que proporciona abreviaturas mas reconocibles para paises y territorios
-
+        dependientes que los codigos alfa-2 sin dejar de ser concisos.
-      - USA = United States
+      ar: >-
-
+        رمز بلد من ثلاثة أحرف يتوافق مع معيار ISO 3166-1 alpha-3، يوفر
-
+        اختصارات أكثر وضوحًا للبلدان والأقاليم التابعة من رموز alpha-2
-      **ONTOLOGY ALIGNMENT**:
+        مع الحفاظ على الإيجاز.
-
+      id: >-
-      - SKOS Concept: Codes are concepts in ISO 3166-1 vocabulary
+        Kode negara tiga huruf yang sesuai dengan standar ISO 3166-1 alpha-3,
-
+        memberikan singkatan yang lebih dikenali untuk negara dan wilayah
-      '
+        dependensi daripada kode alfa-2 sambil tetap ringkas.
+      zh: >-
+        符合ISO 3166-1 alpha-3标准的三字母国家代码，比alpha-2代码提供更具
+        辨识度的国家和属地缩写，同时保持简洁。
+    examples:
+    - value:
+        has_code: NLD
+      description: Netherlands
+    - value:
+        has_code: BEL
+      description: Belgium
+    - value:
+        has_code: DEU
+      description: Germany
+    structured_aliases:
+    - literal_form: alfa-3-code
+      in_language: nl
+    - literal_form: Alpha-3-Code
+      in_language: de
+    - literal_form: code alpha-3
+      in_language: fr
+    - literal_form: codigo alfa-3
+      in_language: es
+    - literal_form: رمز ألفا-3
+      in_language: ar
+    - literal_form: kode alfa-3
+      in_language: id
+    - literal_form: alpha-3代码
+      in_language: zh
+    keywords:
+    - ISO 3166
+    - country code
+    - three-letter
+    - standard
+    - geographic
+    broad_mappings:
+    - skos:Concept
+    - wd:Q42032
     slots:
     - has_code
     slot_usage:
       has_code:
-        pattern: ^[A-Z]{3}$
+        pattern: "^[A-Z]{3}$"
         required: true
         examples:
         - value: NLD
         - value: BEL
-    exact_mappings:
+    comments:
-    - skos:Concept
+    - ISO 3166-1 alpha-3 codes are maintained by ISO
+    - More recognizable than alpha-2 codes
     annotations:
-      specificity_score: '0.30'
+      specificity_score: "0.30"
-      specificity_rationale: Low specificity - standard country codes used broadly.
+      specificity_rationale: Standardized country code format
       custodian_types: "['*']"
-    examples:
-    - value:
-        has_code: NLD

schemas/20251121/linkml/modules/classes/Altitude.yaml

@@ -1,13 +1,14 @@
 id: https://nde.nl/ontology/hc/class/Altitude
 name: Altitude
 title: Altitude
-description: The altitude of a place.
 prefixes:
   linkml: https://w3id.org/linkml/
   schema: http://schema.org/
   skos: http://www.w3.org/2004/02/skos/core#
   rico: https://www.ica.org/standards/RiC/ontology#
+  crm: http://www.cidoc-crm.org/cidoc-crm/
   wd: http://www.wikidata.org/entity/
+default_prefix: hc
 imports:
   - linkml:types
   - ../slots/has_measurement_unit
@@ -15,13 +16,89 @@ imports:
 classes:
   Altitude:
     class_uri: schema:QuantitativeValue
-    exact_mappings:
+    description: >-
-      - crm:E54_Dimension
+      Vertical distance measurement of a location above a reference datum,
-    description: The altitude of a place.
+      typically mean sea level, used for geographic positioning and
+      environmental characterization of heritage sites and storage facilities.
+    alt_descriptions:
+      nl: >-
+        Verticale afstandsmeting van een locatie boven een referentiepunt,
+        doorgaans gemiddeld zeeniveau, gebruikt voor geografische
+        positionering en omgevingskarakteristiek van erfgoedlocaties en
+        opslagfaciliteiten.
+      de: >-
+        Vertikale Distanzmessung eines Standortes ueber einem Referenzdatum,
+        typischerweise mittlerer Meeresspiegel, verwendet zur geografischen
+        Positionierung und Umweltcharakterisierung von Heritage-Standorten und
+        Lagereinrichtungen.
+      fr: >-
+        Mesure de distance verticale d'un emplacement au-dessus d'un datum de
+        reference, generalement le niveau moyen de la mer, utilisee pour le
+        positionnement geographique et la caracterisation environnementale des
+        sites patrimoniaux et des installations de stockage.
+      es: >-
+        Medicion de distancia vertical de una ubicacion sobre un datum de
+        referencia, tipicamente el nivel medio del mar, utilizada para el
+        posicionamiento geografico y la caracterizacion ambiental de sitios
+        patrimoniales e instalaciones de almacenamiento.
+      ar: >-
+        قياس المسافة العمودية لموقع فوق مرجع أساسي، عادة مستوى سطح البحر
+        المتوسط، يُستخدم لتحديد الموقع الجغرافي والخصائص البيئية للمواقع
+        التراثية ومرافق التخزين.
+      id: >-
+        Pengukuran jarak vertikal suatu lokasi di atas datum referensi,
+        biasanya rata-rata permukaan laut, digunakan untuk pemosisian
+        geografis dan karakterisasi lingkungan situs warisan dan fasilitas
+        penyimpanan.
+      zh: >-
+        相对于参考基准（通常为平均海平面）的位置垂直距离测量，用于遗产地点和
+        存储设施的地理定位和环境特征描述。
+    examples:
+    - value:
+        has_value: 52
+        has_measurement_unit: m
+      description: Altitude of 52 meters above sea level
+    - value:
+        has_value: 1500
+        has_measurement_unit: m
+      description: High-altitude storage facility at 1500m
+    structured_aliases:
+    - literal_form: hoogte
+      in_language: nl
+    - literal_form: Hoehe
+      in_language: de
+    - literal_form: altitude
+      in_language: fr
+    - literal_form: altitud
+      in_language: es
+    - literal_form: ارتفاع
+      in_language: ar
+    - literal_form: ketinggian
+      in_language: id
+    - literal_form: 海拔
+      in_language: zh
+    keywords:
+    - elevation
+    - height
+    - sea level
+    - geographic
+    - vertical
+    broad_mappings:
+    - schema:QuantitativeValue
+    - crm:E54_Dimension
     slots:
     - has_value
     - has_measurement_unit
+    slot_usage:
+      has_value:
+        range: float
+        required: true
+      has_measurement_unit:
+        required: true
+    comments:
+    - Important for environmental control planning
+    - Affects preservation conditions for collections
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.2"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Geographic measurement for location characterization
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/AmendmentEvent.yaml

@@ -1,14 +1,16 @@
 id: https://nde.nl/ontology/hc/class/AmendmentEvent
 name: AmendmentEvent
 title: Amendment Event
-description: An event where a document or agreement was amended.
 prefixes:
-  rov: http://www.w3.org/ns/regorg#
   linkml: https://w3id.org/linkml/
+  hc: https://nde.nl/ontology/hc/
   schema: http://schema.org/
   skos: http://www.w3.org/2004/02/skos/core#
   rico: https://www.ica.org/standards/RiC/ontology#
+  prov: http://www.w3.org/ns/prov#
+  crm: http://www.cidoc-crm.org/cidoc-crm/
   wd: http://www.wikidata.org/entity/
+default_prefix: hc
 imports:
   - linkml:types
   - ../slots/has_description
@@ -17,12 +19,81 @@ imports:
 classes:
   AmendmentEvent:
     class_uri: prov:Activity
-    description: An event where a document or agreement was amended.
+    description: >-
+      Occurrence of modifying or revising a document, agreement, or policy,
+      capturing when changes were made and describing the nature of the
+      modifications within institutional records.
+    alt_descriptions:
+      nl: >-
+        Gebeurtenis waarbij een document, overeenkomst of beleid wordt gewijzigd
+        of herzien, vastleggend wanneer wijzigingen zijn aangebracht en de aard
+        van de wijzigingen beschrijvend binnen institutionele archieven.
+      de: >-
+        Ereignis der Aenderung oder Ueberarbeitung eines Dokuments, einer
+        Vereinbarung oder Richtlinie, das erfasst, wann Aenderungen vorgenommen
+        wurden, und die Art der Aenderungen in institutionellen Unterlagen
+        beschreibt.
+      fr: >-
+        Evenement de modification ou de revision d'un document, d'un accord ou
+        d'une politique, capturant quand des modifications ont ete apportees et
+        decrivant la nature des changements dans les archives institutionnelles.
+      es: >-
+        Evento de modificacion o revision de un documento, acuerdo o politica,
+        capturando cuando se realizaron cambios y describiendo la naturaleza de
+        las modificaciones en los registros institucionales.
+      ar: >-
+        حدث تعديل أو مراجعة وثيقة أو اتفاق أو سياسة، مع تسجيل وقت إجراء
+        التغييرات ووصف طبيعة التعديلات في السجلات المؤسسية.
+      id: >-
+        Peristiwa modifikasi atau revisi dokumen, perjanjian, atau kebijakan,
+        mencatat kapan perubahan dilakukan dan mendeskripsikan sifat modifikasi
+        dalam arsip institusional.
+      zh: >-
+        修改或修订文档、协议或政策的事件，记录更改发生的时间并描述机构档案中
+        修改的性质。
+    examples:
+    - value:
+        has_description: Policy clause 4.2 updated to reflect new regulations
+        temporal_extent:
+          start_date: "2024-03-15"
+      description: Amendment to institutional policy
+    structured_aliases:
+    - literal_form: wijzigingsgebeurtenis
+      in_language: nl
+    - literal_form: Aenderungsereignis
+      in_language: de
+    - literal_form: evenement de modification
+      in_language: fr
+    - literal_form: evento de enmienda
+      in_language: es
+    - literal_form: حدث التعديل
+      in_language: ar
+    - literal_form: peristiwa amandemen
+      in_language: id
+    - literal_form: 修订事件
+      in_language: zh
+    keywords:
+    - modification
+    - revision
+    - update
+    - policy change
+    - document
+    broad_mappings:
+    - prov:Activity
+    - crm:E11_Modification
     slots:
     - temporal_extent
     - has_description
     - identified_by
+    slot_usage:
+      temporal_extent:
+        required: true
+      has_description:
+        required: false
+    comments:
+    - Records document version history and changes
+    - May be linked to Agreement or Policy classes
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.15"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Specific event type for document modification tracking
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/Animal.yaml

@@ -1,6 +1,6 @@
 id: https://nde.nl/ontology/hc/class/Animal
 name: Animal
-title: Animal Class
+title: Animal
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
@@ -9,10 +9,6 @@ prefixes:
   dcterms: http://purl.org/dc/terms/
   prov: http://www.w3.org/ns/prov#
   crm: http://www.cidoc-crm.org/cidoc-crm/
-  skos: http://www.w3.org/2004/02/skos/core#
-  rdfs: http://www.w3.org/2000/01/rdf-schema#
-  org: http://www.w3.org/ns/org#
-  xsd: http://www.w3.org/2001/XMLSchema#
 default_prefix: hc
 imports:
   - linkml:types
@@ -22,14 +18,80 @@ imports:
 classes:
   Animal:
     class_uri: schema:Animal
-    description: 'An animal.
+    description: >-
-
+      Living organism belonging to the kingdom Animalia, characterized by
-
+      voluntary movement, consumption of organic material, and typically
-      **Ontological Alignment**:
+      sensory and nervous systems, relevant to natural history collections
-
+      and zoological specimens.
-      - `schema:Animal`: Generic animal class.
+    alt_descriptions:
-
+      nl: >-
-      '
+        Levend organisme behorend tot het dierenrijk, gekenmerkt door
+        vrijwillige beweging, consumptie van organisch materiaal en typisch
+        zintuiglijke en zenuwstelsels, relevant voor natuurhistorische
+        collecties en zoologische specimens.
+      de: >-
+        Lebewesen, das zum Tierreich gehoert, gekennzeichnet durch freiwillige
+        Bewegung, Konsum von organischem Material und typischerweise
+        Sinnesorgane und Nervensysteme, relevant fuer naturkundliche Sammlungen
+        und zoologische Exemplare.
+      fr: >-
+        Organisme vivant appartenant au regne animal, caracterise par le
+        mouvement volontaire, la consommation de matiere organique et
+        generalement des systemes sensoriels et nerveux, pertinent pour les
+        collections d'histoire naturelle et les specimens zoologiques.
+      es: >-
+        Organismo vivo perteneciente al reino animal, caracterizado por
+        movimiento voluntario, consumo de material organico y tipicamente
+        sistemas sensoriales y nerviosos, relevante para colecciones de
+        historia natural y especimenes zoologicos.
+      ar: >-
+        كائن حي ينتمي إلى مملكة الحيوان، يتميز بالحركة الإرادية واستهلاك
+        المواد العضوية وعادة ما يكون له أنظمة حسية وعصبية، ذو صلة بمجموعات
+        التاريخ الطبيعي والعينات الحيوانية.
+      id: >-
+        Organisme hidup yang termasuk dalam kerajaan Animalia, dicirikan oleh
+        gerakan sukarela, konsumsi bahan organik, dan biasanya memiliki sistem
+        sensorik dan saraf, relevan untuk koleksi sejarah alam dan spesimen
+        zoologi.
+      zh: >-
+        属于动物界的生物，具有自主运动、消耗有机物质以及通常具有感觉和神经
+        系统的特征，与自然历史收藏和动物标本相关。
+    examples:
+    - value:
+        has_label: African Elephant
+        categorized_as: Loxodonta africana
+      description: A mammal specimen in natural history collection
+    - value:
+        has_label: Monarch Butterfly
+        categorized_as: Danaus plexippus
+      description: An insect specimen
+    structured_aliases:
+    - literal_form: dier
+      in_language: nl
+    - literal_form: Tier
+      in_language: de
+    - literal_form: animal
+      in_language: fr
+    - literal_form: animal
+      in_language: es
+    - literal_form: حيوان
+      in_language: ar
+    - literal_form: hewan
+      in_language: id
+    - literal_form: 动物
+      in_language: zh
+    keywords:
+    - organism
+    - specimen
+    - natural history
+    - zoological
+    - wildlife
+    - fauna
+    exact_mappings:
+    - schema:Animal
+    broad_mappings:
+    - wd:Q729
+    - schema:Thing
     slots:
     - has_label
     - has_description
@@ -37,7 +99,10 @@ classes:
     slot_usage:
       categorized_as:
         range: Species
+    comments:
+    - Used for biological specimens in natural history collections
+    - categorization typically references taxonomic species classification
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.2"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Applicable to natural history and zoological contexts
-      custodian_types: "['*']"
+      custodian_types: "['NaturalHistoryMuseum', 'Zoo']"

schemas/20251121/linkml/modules/classes/AnimalSoundArchive.yaml

@@ -1,8 +1,14 @@
 id: https://nde.nl/ontology/hc/class/AnimalSoundArchive
 name: AnimalSoundArchive
-title: Animal Sound Archive Type
+title: Animal Sound Archive
 prefixes:
   linkml: https://w3id.org/linkml/
+  hc: https://nde.nl/ontology/hc/
+  schema: http://schema.org/
+  skos: http://www.w3.org/2004/02/skos/core#
+  rico: https://www.ica.org/standards/RiC/ontology#
+  wd: http://www.wikidata.org/entity/
+default_prefix: hc
 imports:
   - linkml:types
   - ../slots/identified_by
@@ -13,28 +19,95 @@ imports:
 classes:
   AnimalSoundArchive:
     is_a: ArchiveOrganizationType
-    class_uri: skos:Concept
+    class_uri: schema:ArchiveOrganization
+    description: >-
+      Archive institution specializing in the collection, preservation, and
+      study of bioacoustic recordings, including wildlife vocalizations,
+      environmental soundscapes, and species identification recordings for
+      research and conservation purposes.
+    alt_descriptions:
+      nl: >-
+        Archiefinstelling gespecialiseerd in het verzamelen, bewaren en
+        bestuderen van bioakoestische opnames, waaronder dierengeluiden,
+        omgevingsgeluiden en soortidentificatie-opnames voor onderzoek en
+        natuurbehoud.
+      de: >-
+        Archivinstitution, die sich auf die Sammlung, Erhaltung und Erforschung
+        von bioakustischen Aufnahmen spezialisiert, einschliesslich
+        Tierlauten, Umgebungsgeraeuschen und Artenbestimmungsaufnahmen fuer
+        Forschungs- und Naturschutzzwecke.
+      fr: >-
+        Institution d'archives specialisee dans la collecte, la preservation et
+        l'etude des enregistrements bioacoustiques, y compris les vocalisations
+        animales, les paysages sonores environnementaux et les enregistrements
+        d'identification des especes a des fins de recherche et de conservation.
+      es: >-
+        Institucion de archivo especializada en la coleccion, preservacion y
+        estudio de grabaciones bioacusticas, incluyendo vocalizaciones de
+        fauna, paisajes sonoros ambientales y grabaciones de identificacion de
+        especies para fines de investigacion y conservacion.
+      ar: >-
+        مؤسسة أرشيفية متخصصة في جمع وحفظ ودراسة التسجيلات البيوacosستية، بما في ذلك
+        أصوات الحيوانات والمشاهد الصوتية البيئية وتسجيلات تحديد الأنواع لأغراض
+        البحث والحفظ.
+      id: >-
+        Lembaga arsip yang mengkhususkan diri dalam pengumpulan, pelestarian,
+        dan studi rekaman bioakustik, termasuk vokalisasi satwa liar, lanskap
+        suara lingkungan, dan rekaman identifikasi spesies untuk tujuan
+        penelitian dan konservasi.
+      zh: >-
+        专门从事生物声学录音收集、保存和研究的档案机构，包括野生动物叫声、
+        环境声景和物种识别录音，用于研究和保护目的。
+    examples:
+    - value:
+        has_type: hc:ArchiveOrganizationType
+        has_label: Tierstimmenarchiv Berlin
+        hold_record_set:
+        - hc:BioacousticRecordingCollection
+      description: Museum für Naturkunde Berlin animal sound archive
+    structured_aliases:
+    - literal_form: dierengeluidarchief
+      in_language: nl
+    - literal_form: Tierstimmenarchiv
+      in_language: de
+    - literal_form: archive de sons animaux
+      in_language: fr
+    - literal_form: archivo de sonidos de animales
+      in_language: es
+    - literal_form: أرشيف أصوات الحيوانات
+      in_language: ar
+    - literal_form: arsip suara hewan
+      in_language: id
+    - literal_form: 动物声音档案馆
+      in_language: zh
+    keywords:
+    - bioacoustic
+    - wildlife sounds
+    - animal vocalizations
+    - natural sounds
+    - sound archive
+    - species identification
+    broad_mappings:
+    - skos:Concept
+    - schema:ArchiveOrganization
+    close_mappings:
+    - rico:CorporateBody
+    - wd:Q18574935
     slots:
     - hold_record_set
     - has_score
-    description: "Archive specializing in animal sound recordings for research and preservation.\n\n**Wikidata**: Q18574935\n\n**Scope**:\nAnimal sound archives (Tierstimmenarchive) preserve:\n- Bioacoustic recordings of wildlife\n- Species identification recordings\n- Environmental soundscapes with animal vocalizations\n- Scientific research recordings\n- Educational materials for species identification\n\n**Scientific Context**:\nThese archives support:\n- Biodiversity monitoring and conservation\n- Species identification and taxonomy\n- Behavioral ecology research\n- Environmental impact assessment\n- Educational outreach\n\n**Related Types**:\n- SoundArchive (Q2230431) - Broader audio collection type\n- ScientificArchive (Q27032095) - Research-focused archives\n\n**Notable Examples**:\n- Tierstimmenarchiv (Museum f\xFCr Naturkunde Berlin)\n- Macaulay Library (Cornell Lab of Ornithology)\n- British Library Sound Archive wildlife collection\n"
     slot_usage:
       identified_by:
-        pattern: ^Q[0-9]+$
+        pattern: "^Q[0-9]+$"
-    exact_mappings:
-    - skos:Concept
-    close_mappings:
-    - schema:ArchiveOrganization
-    - rico:CorporateBody
     comments:
     - Specialized sound archive for bioacoustic and wildlife recordings
     - Often affiliated with natural history museums or research institutions
-    - 'Part of dual-class pattern: custodian type + rico:RecordSetType'
+    - Part of dual-class pattern: custodian type + rico:RecordSetType
-    - Important for biodiversity conservation and scientific research
     see_also:
     - SoundArchive
     - ScientificArchive
+    - AnimalSoundArchiveRecordSetType
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.25"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Specialized archive type for bioacoustic collections
-      custodian_types: "['*']"
+      custodian_types: "['AnimalSoundArchive']"

schemas/20251121/linkml/modules/classes/AnimalSoundArchiveRecordSetType.yaml

@@ -1,9 +1,13 @@
 id: https://nde.nl/ontology/hc/class/AnimalSoundArchiveRecordSetType
 name: AnimalSoundArchiveRecordSetType
-title: AnimalSoundArchive Record Set Type
+title: Animal Sound Archive Record Set Type
 prefixes:
   linkml: https://w3id.org/linkml/
+  hc: https://nde.nl/ontology/hc/
   wd: http://www.wikidata.org/entity/
+  rico: https://www.ica.org/standards/RiC/ontology#
+  skos: http://www.w3.org/2004/02/skos/core#
+default_prefix: hc
 imports:
   - linkml:types
   - ../slots/has_score
@@ -11,14 +15,50 @@ imports:
   - ../slots/related_to
 classes:
   AnimalSoundArchiveRecordSetType:
-    description: A rico:RecordSetType for classifying collections of animal sound archive materials within heritage institutions.
+    description: >-
+      Classification category for record sets within animal sound archives,
+      distinguishing types of bioacoustic collections based on content,
+      recording methodology, or organizational structure.
+    alt_descriptions:
+      nl: >-
+        Classificatiecategorie voor archiefbestanden binnen dierengeluidarchieven,
+        onderscheidend types bioakoestische collecties op basis van inhoud,
+        opnamemethodologie of organisatiestructuur.
+      de: >-
+        Klassifikationskategorie fuer Bestandsgruppen in Tierstimmenarchiven,
+        die Arten von bioakustischen Sammlungen nach Inhalt,
+        Aufnahmemethodologie oder Organisationsstruktur unterscheidet.
+      fr: >-
+        Categorie de classification pour les ensembles d'archives dans les
+        archives de sons animaux, distinguant les types de collections
+        bioacoustiques en fonction du contenu, de la methodologie d'enregistrement
+        ou de la structure organisationnelle.
+      es: >-
+        Categoria de clasificacion para conjuntos de registros en archivos de
+        sonidos de animales, distinguiendo tipos de colecciones bioacusticas
+        segun el contenido, la metodologia de grabacion o la estructura
+        organizativa.
+      ar: >-
+        فئة تصنيفية لمجموعات السجلات في أرشيفات أصوات الحيوانات، تميز أنواع
+        المجموعات البيوacosستية بناءً على المحتوى أو منهجية التسجيل أو
+        الهيكل التنظيمي.
+      id: >-
+        Kategori klasifikasi untuk kumpulan rekaman dalam arsip suara hewan,
+        membedakan jenis koleksi bioakustik berdasarkan konten, metodologi
+        perekaman, atau struktur organisasi.
+      zh: >-
+        动物声音档案馆内档案组的分类类别，根据内容、录制方法或组织结构
+        区分生物声学收藏的类型。
     is_a: CollectionType
     class_uri: rico:RecordSetType
-    exact_mappings:
+    broad_mappings:
+    - rico:RecordSetType
+    - skos:Concept
+    close_mappings:
     - wd:Q18574935
     slot_usage:
       has_type:
-        equals_expression: '["hc:ArchiveOrganizationType"]'
+        equals_string: "hc:ArchiveOrganizationType"
       related_to:
         range: WikidataAlignment
         inlined: true
@@ -28,7 +68,10 @@ classes:
     - has_type
     - has_score
     - related_to
+    comments:
+    - RiC-O RecordSetType classification for animal sound collections
+    - Paired with AnimalSoundArchive custodian type
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.2"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Specialized record set type for bioacoustic archives
-      custodian_types: "['*']"
+      custodian_types: "['AnimalSoundArchive']"

schemas/20251121/linkml/modules/classes/AnimalSoundArchiveRecordSetTypes.yaml

@@ -1,6 +1,6 @@
 id: https://nde.nl/ontology/hc/class/AnimalSoundArchiveRecordSetTypes
 name: AnimalSoundArchiveRecordSetTypes
-title: AnimalSoundArchive Record Set Type Subclasses
+title: Animal Sound Archive Record Set Type Subclasses
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
@@ -21,15 +21,51 @@ classes:
   BioacousticRecordingCollection:
     is_a: AnimalSoundArchiveRecordSetType
     class_uri: rico:RecordSetType
-    description: "A rico:RecordSetType for Animal and nature sound recordings.\n\n\
+    description: >-
-      **RiC-O Alignment**:\nThis class is a specialized rico:RecordSetType following\
+      Collection of animal and nature sound recordings for research,
-      \ the collection \norganizational principle as defined by rico-rst:Collection.\n"
+      species identification, and biodiversity documentation purposes.
+    alt_descriptions:
+      nl: >-
+        Collectie van dier- en natuurgeluidsopnames voor onderzoek,
+        soortidentificatie en biodiversiteitsdocumentatie.
+      de: >-
+        Sammlung von Tier- und Naturgeraeuschaufnahmen fuer Forschungs-,
+        Artenbestimmungs- und Biodiversitaetsdokumentationszwecke.
+      fr: >-
+        Collection d'enregistrements de sons animaux et naturels pour la
+        recherche, l'identification des especes et la documentation de la
+        biodiversite.
+      es: >-
+        Coleccion de grabaciones de sonidos de animales y naturaleza para
+        investigacion, identificacion de especies y documentacion de
+        biodiversidad.
+      ar: >-
+        مجموعة من تسجيلات أصوات الحيوانات والطبيعة لأغراض البحث وتحديد
+        الأنواع وتوثيق التنوع البيولوجي.
+      id: >-
+        Koleksi rekaman suara hewan dan alam untuk penelitian, identifikasi
+        spesies, dan dokumentasi keanekaragaman hayati.
+      zh: >-
+        用于研究、物种识别和生物多样性记录的动物和自然声音录音收藏。
+    structured_aliases:
+    - literal_form: bioakoestische opnamecollectie
+      in_language: nl
+    - literal_form: Bioakustische Aufnahmesammlung
+      in_language: de
+    - literal_form: collection d'enregistrements bioacoustiques
+      in_language: fr
+    - literal_form: coleccion de grabaciones bioacusticas
+      in_language: es
+    - literal_form: مجموعة التسجيلات البيوacosستية
+      in_language: ar
+    - literal_form: koleksi rekaman bioakustik
+      in_language: id
+    - literal_form: 生物声学录音收藏
+      in_language: zh
     broad_mappings:
     - rico:RecordSetType
     related_mappings:
     - rico-rst:Collection
-    close_mappings:
-    - skos:Concept
     see_also:
     - AnimalSoundArchiveRecordSetType
     - rico:RecordSetType
@@ -38,33 +74,73 @@ classes:
     - has_score
     - has_custodian
     - record_holder_note
-    - has_type
     slot_usage:
       has_type:
-        equals_expression: '["hc:ArchiveOrganizationType"]'
+        equals_string: "hc:ArchiveOrganizationType"
-      has_type:
-        equals_string: BioacousticRecordingCollection
       has_custodian:
-        equals_string: AnimalSoundArchive
+        equals_string: "AnimalSoundArchive"
       record_holder_note:
-        equals_string: This RecordSetType is typically held by AnimalSoundArchive
+        equals_string: "This RecordSetType is typically held by AnimalSoundArchive custodians. Inverse of rico:isOrWasHolderOf."
-          custodians. Inverse of rico:isOrWasHolderOf.
+    comments:
+    - RiC-O specialized collection type following rico-rst:Collection principle
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.25"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Specialized bioacoustic collection type
-      custodian_types: '[''*'']'
+      custodian_types: "['AnimalSoundArchive']"
   FieldRecordingSeries:
     is_a: AnimalSoundArchiveRecordSetType
     class_uri: rico:RecordSetType
-    description: "A rico:RecordSetType for Field research audio.\n\n**RiC-O Alignment**:\n\
+    description: >-
-      This class is a specialized rico:RecordSetType following the series \norganizational\
+      Series of field research audio recordings documenting wildlife in
-      \ principle as defined by rico-rst:Series.\n"
+      natural habitats, typically organized by expedition, location, or
+      research project.
+    alt_descriptions:
+      nl: >-
+        Reeks veldonderzoeks-audio-opnames die wildlife documenteren in
+        natuurlijke habitats, typisch georganiseerd per expeditie, locatie
+        of onderzoeksproject.
+      de: >-
+        Serie von Feldforschungsaudioaufnahmen, die Wildtiere in natuerlichen
+        Lebensraeumen dokumentieren, typischerweise organisiert nach Expedition,
+        Standort oder Forschungsprojekt.
+      fr: >-
+        Serie d'enregistrements audio de recherche de terrain documentant la
+        faune dans les habitats naturels, generalement organises par expedition,
+        lieu ou projet de recherche.
+      es: >-
+        Serie de grabaciones de audio de investigacion de campo que documentan
+        la fauna en habitats naturales, tipicamente organizadas por expedicion,
+        ubicacion o proyecto de investigacion.
+      ar: >-
+        سلسلة من التسجيلات الصوتية للبحث الميداني توثق الحيوانات البرية في
+        الموائل الطبيعية، عادة ما تكون منظمة حسب البعثة أو الموقع أو
+        مشروع البحث.
+      id: >-
+        Seri rekaman audio penelitian lapangan yang mendokumentasikan satwa liar
+        di habitat alami, biasanya diorganisir berdasarkan ekspedisi, lokasi,
+        atau proyek penelitian.
+      zh: >-
+        记录自然栖息地野生动物的野外研究音频录音系列，通常按探险、地点或
+        研究项目组织。
+    structured_aliases:
+    - literal_form: veldopnameserie
+      in_language: nl
+    - literal_form: Feldaufnahmeserie
+      in_language: de
+    - literal_form: serie d'enregistrements de terrain
+      in_language: fr
+    - literal_form: serie de grabaciones de campo
+      in_language: es
+    - literal_form: سلسلة التسجيلات الميدانية
+      in_language: ar
+    - literal_form: seri rekaman lapangan
+      in_language: id
+    - literal_form: 野外录音系列
+      in_language: zh
     broad_mappings:
     - rico:RecordSetType
     related_mappings:
     - rico-rst:Series
-    close_mappings:
-    - skos:Concept
     see_also:
     - AnimalSoundArchiveRecordSetType
     - rico:RecordSetType
@@ -73,14 +149,16 @@ classes:
     - has_score
     - has_custodian
     - record_holder_note
-    - has_type
     slot_usage:
       has_type:
-        equals_expression: '["hc:ArchiveOrganizationType"]'
+        equals_string: "hc:ArchiveOrganizationType"
-      has_type:
-        equals_string: FieldRecordingSeries
       has_custodian:
-        equals_string: AnimalSoundArchive
+        equals_string: "AnimalSoundArchive"
       record_holder_note:
-        equals_string: This RecordSetType is typically held by AnimalSoundArchive
+        equals_string: "This RecordSetType is typically held by AnimalSoundArchive custodians. Inverse of rico:isOrWasHolderOf."
-          custodians. Inverse of rico:isOrWasHolderOf.
+    comments:
+    - RiC-O specialized series type following rico-rst:Series principle
+    annotations:
+      specificity_score: "0.25"
+      specificity_rationale: Specialized field recording series type
+      custodian_types: "['AnimalSoundArchive']"

schemas/20251121/linkml/modules/classes/AnnexCreationEvent.yaml

@@ -1,11 +1,12 @@
 id: https://nde.nl/ontology/hc/class/AnnexCreationEvent
 name: AnnexCreationEvent
-title: AnnexCreationEvent
+title: Annex Creation Event
-description: Event of creating an annex.
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
   prov: http://www.w3.org/ns/prov#
+  schema: http://schema.org/
+  crm: http://www.cidoc-crm.org/cidoc-crm/
 default_prefix: hc
 imports:
   - linkml:types
@@ -14,11 +15,79 @@ imports:
 classes:
   AnnexCreationEvent:
     class_uri: prov:Activity
-    description: Annex creation event.
+    description: >-
+      Occurrence of establishing an annex, branch, or subsidiary facility
+      connected to a main heritage institution, capturing when and why the
+      organizational expansion took place.
+    alt_descriptions:
+      nl: >-
+        Gebeurtenis waarbij een bijlage, filiaal of dochterfaciliteit wordt
+        opgericht die verbonden is aan een hoofderfgoedinstelling, vastleggend
+        wanneer en waarom de organisatorische uitbreiding plaatsvond.
+      de: >-
+        Ereignis der Gruendung einer Annex-, Zweig- oder Tochtereinrichtung,
+        die mit einer Haupt-heritage-Institution verbunden ist, das erfasst,
+        wann und warum die organisatorische Erweiterung stattfand.
+      fr: >-
+        Evenement de creation d'une annexe, d'une succursale ou d'une
+        installation filiale reliee a une institution patrimoniale principale,
+        capturant quand et pourquoi l'expansion organisationnelle a eu lieu.
+      es: >-
+        Evento de establecimiento de una anexa, sucursal o instalacion
+        filial conectada a una institucion patrimonial principal, capturando
+        cuando y por que tuvo lugar la expansion organizativa.
+      ar: >-
+        حدث إنشاء ملحق أو فرع أو منشأة تابعة مرتبطة بمؤسسة تراثية رئيسية،
+        مع تسجيل متى ولماذا حدث التوسع التنظيمي.
+      id: >-
+        Peristiwa pendirian aneks, cabang, atau fasilitas anak perusahaan yang
+        terhubung dengan lembaga warisan utama, mencatat kapan dan mengapa
+        ekspansi organisasi terjadi.
+      zh: >-
+        建立与主要遗产机构相连的附属、分支或子公司设施的事件，记录组织扩张
+        发生的时间和原因。
+    examples:
+    - value:
+        has_reason: Expansion of storage capacity for growing collections
+        temporal_extent:
+          start_date: "2024-06-01"
+      description: Creation of new storage annex
+    structured_aliases:
+    - literal_form: bijlagecreatiegebeurtenis
+      in_language: nl
+    - literal_form: Annexgruendungsereignis
+      in_language: de
+    - literal_form: evenement de creation d'annexe
+      in_language: fr
+    - literal_form: evento de creacion de anexa
+      in_language: es
+    - literal_form: حدث إنشاء الملحق
+      in_language: ar
+    - literal_form: peristiwa pembentukan aneks
+      in_language: id
+    - literal_form: 附属创建事件
+      in_language: zh
+    keywords:
+    - expansion
+    - branch
+    - facility
+    - organizational change
+    - annex
+    broad_mappings:
+    - prov:Activity
+    - crm:E66_Formation
     slots:
     - has_reason
     - temporal_extent
+    slot_usage:
+      has_reason:
+        required: false
+      temporal_extent:
+        required: true
+    comments:
+    - Records institutional growth and expansion events
+    - May be linked to organizational structure changes
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.15"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Specific event type for organizational expansion
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/Annotation.yaml

@@ -6,6 +6,8 @@ prefixes:
   hc: https://nde.nl/ontology/hc/
   oa: http://www.w3.org/ns/oa#
   schema: http://schema.org/
+  skos: http://www.w3.org/2004/02/skos/core#
+  prov: http://www.w3.org/ns/prov#
 default_prefix: hc
 imports:
   - linkml:types
@@ -17,14 +19,61 @@ imports:
 classes:
   Annotation:
     class_uri: oa:Annotation
-    description: 'An annotation (comment, note, tag, highlight) on a resource.
+    description: >-
-
+      Supplemental information attached to a resource, such as comments, notes,
-
+      tags, or highlighted segments. Part of the W3C Web Annotation Data Model
-      **Ontological Alignment**:
+      for interoperable annotation systems.
-
+    alt_descriptions:
-      - `oa:Annotation`: Web Annotation Data Model.
+      nl: >-
-
+        Aanvullende informatie toegevoegd aan een bron, zoals opmerkingen, notities,
-      '
+        tags of gemarkeerde segmenten. Onderdeel van het W3C Web Annotation Data Model
+        voor interoperabele annotatiesystemen.
+      de: >-
+        Zusatzliche Informationen, die einer Ressource angehangt werden, wie Kommentare,
+        Notizen, Tags oder hervorgehobene Abschnitte. Teil des W3C Web Annotation Data
+        Model fur interoperable Annotationssysteme.
+      fr: >-
+        Information supplementaire jointe a une ressource, telle que des commentaires,
+        notes, balises ou segments mis en evidence. Fait partie du modele de donnees
+        W3C Web Annotation pour les systemes d'annotation interoperables.
+      es: >-
+        Informacion adicional adjunta a un recurso, como comentarios, notas, etiquetas
+        o segmentos resaltados. Parte del modelo de datos W3C Web Annotation para
+        sistemas de anotacion interoperables.
+      ar: >-
+        معلومات إضافية مرفقة بمورد، مثل التعليقات والملاحظات والعلامات أو الأجزاء
+        المميزة. جزء من نموذج بيانات شرح الويب W3C للأنظمة التفاعلية.
+      id: >-
+        Informasi tambahan yang dilampirkan ke sumber daya, seperti komentar, catatan,
+        tag, atau segmen yang disorot. Bagian dari Model Data Anotasi Web W3C untuk
+        sistem anotasi yang dapat dioperasikan.
+      zh: >-
+        附加到资源的补充信息，如评论、注释、标签或高亮片段。属于W3C Web注释数据模型，
+        用于可互操作的注释系统。
+    structured_aliases:
+    - literal_form: annotatie
+      in_language: nl
+    - literal_form: Anmerkung
+      in_language: de
+    - literal_form: annotation
+      in_language: fr
+    - literal_form: anotacion
+      in_language: es
+    - literal_form: تعليق توضيحي
+      in_language: ar
+    - literal_form: anotasi
+      in_language: id
+    - literal_form: 注释
+      in_language: zh
+    exact_mappings:
+    - oa:Annotation
+    close_mappings:
+    - schema:Comment
+    - schema:UserComments
+    related_mappings:
+    - prov:Entity
+    broad_mappings:
+    - skos:Concept
     slots:
     - has_description
     - created_by
@@ -33,6 +82,7 @@ classes:
     - has_type
     slot_usage:
       has_description:
+        required: false
       created_by:
         range: Agent
       has_rationale:
@@ -41,7 +91,35 @@ classes:
         range: Segment
       has_type:
         range: AnnotationType
+    examples:
+    - value:
+        has_type: hc:CommentAnnotation
+        has_description: "This image depicts the Battle of Waterloo, 1815."
+        created_by: "https://example.org/users/historian123"
+      description: A scholarly comment annotation on an image
+    - value:
+        has_type: hc:TagAnnotation
+        has_description: "Waterloo; Napoleon; 19th century"
+        created_by: "https://example.org/users/cataloger"
+      description: A tagging annotation for subject classification
+    keywords:
+    - comment
+    - note
+    - tag
+    - highlight
+    - markup
+    - web annotation
+    - scholarly annotation
+    - user-generated content
+    comments:
+    - Part of W3C Web Annotation Data Model (https://www.w3.org/TR/annotation-vocab/)
+    - Enables interoperable annotation across platforms and systems
+    - Supports multiple motivation types (commenting, tagging, describing, etc.)
+    see_also:
+    - https://www.w3.org/TR/annotation-vocab/
+    - AnnotationType
+    - AnnotationMotivationType
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.2"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Core annotation class from W3C Web Annotation standard
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/AnnotationMotivationType.yaml

@@ -26,12 +26,58 @@ classes:
   AnnotationMotivationType:
     class_uri: oa:Motivation
     abstract: true
-    description: "Abstract base class for annotation motivation types in the heritage domain.\n\n**DEFINITION**:\n\nAnnotationMotivationType represents CATEGORIES of motivations for creating\nannotations. Each subclass defines a specific purpose or intent behind\nannotation creation.\n\n**W3C WEB ANNOTATION ALIGNMENT**:\n\nThe W3C Web Annotation Data Model defines `oa:Motivation` as:\n> The class for Motivation resources that describe the user's intent\n> or motivation for the creation of the Annotation.\n\nThe `oa:Motivation` class is a subclass of `skos:Concept`:\n```turtle\noa:Motivation a rdfs:Class ;\n    rdfs:subClassOf skos:Concept .\n```\n\n**STANDARD MOTIVATIONS** (from W3C Web Annotation):\n\n| Motivation | URI | Description |\n|------------|-----|-------------|\n| classifying | oa:classifying | Categorizing or classifying content |\n| commenting | oa:commenting | Adding commentary |\n| describing | oa:describing | Adding descriptive information |\n| identifying | oa:identifying\
+    description: >-
-      \ | Identifying depicted entities |\n| linking | oa:linking | Linking to external resources |\n| tagging | oa:tagging | Adding tags or keywords |\n\n**HERITAGE-SPECIFIC EXTENSIONS**:\n\nBeyond W3C standard motivations, heritage institutions require:\n\n| Motivation | Purpose | Use Case |\n|------------|---------|----------|\n| AccessibilityMotivation | Accessibility support | Alt-text, captions, audio descriptions |\n| DiscoveryMotivation | Search and discovery | SEO, facets, keywords |\n| PreservationMotivation | Digital preservation | Checksums, format migration notes |\n| ResearchMotivation | Research support | Citations, analysis, scholarly notes |\n\n**CIDOC-CRM ALIGNMENT**:\n\nAnnotation motivations relate to CIDOC-CRM attribute assignments:\n- `crm:E13_Attribute_Assignment` - The act of assigning information\n- `crm:P17_was_motivated_by` - The motivation for an activity\n\n**PROV-O ALIGNMENT**:\n\n- `prov:Activity` - Annotations as activities with motivations\n- `prov:wasMotivatedBy`\
+      Abstract base class for categories of reasons or intents behind creating
-      \ (proposed) - Relates activity to motivation\n\n**SUBCLASSES**:\n\nSee AnnotationMotivationTypes.yaml for 10 concrete motivation subclasses:\n- ClassifyingMotivation, DescribingMotivation, IdentifyingMotivation\n- TaggingMotivation, LinkingMotivation, CommentingMotivation\n- AccessibilityMotivation, DiscoveryMotivation, PreservationMotivation, ResearchMotivation\n"
+      annotations. Each subclass defines a specific purpose such as classifying,
+      commenting, describing, identifying, linking, or tagging content.
+    alt_descriptions:
+      nl: >-
+        Abstracte basisklasse voor categorieen van redenen of intenties achter het
+        maken van annotaties. Elke subklasse definieert een specifiek doel zoals
+        classificeren, becommentarieren, beschrijven, identificeren, koppelen of
+        taggen van inhoud.
+      de: >-
+        Abstrakte Basisklasse fur Kategorien von Grunden oder Absichten hinter der
+        Erstellung von Annotationen. Jede Unterklasse definiert einen spezifischen
+        Zweck wie Klassifizieren, Kommentieren, Beschreiben, Identifizieren,
+        Verknupfen oder Taggen von Inhalten.
+      fr: >-
+        Classe de base abstraite pour les categories de raisons ou intentions derriere
+        la creation d'annotations. Chaque sous-classe definit un objectif specifique
+        tel que classifier, commenter, decrire, identifier, lier ou etiqueter du contenu.
+      es: >-
+        Clase base abstracta para categorias de razones o intenciones detras de la
+        creacion de anotaciones. Cada subclase define un proposito especifico como
+        clasificar, comentar, describir, identificar, vincular o etiquetar contenido.
+      ar: >-
+        فئة أساسية مجردة لفئات الأسباب أو النوايا وراء إنشاء التعليقات التوضيحية.
+        يحدد كل فئة فرعية غرضًا محددًا مثل التصنيف أو التعليق أو الوصف أو
+        التعريف أو الربط أو وضع العلامات على المحتوى.
+      id: >-
+        Kelas dasar abstrak untuk kategori alasan atau niat di balik pembuatan anotasi.
+        Setiap subkelas mendefinisikan tujuan spesifik seperti mengklasifikasikan,
+        mengomentari, mendeskripsikan, mengidentifikasi, menautkan, atau menandai konten.
+      zh: >-
+        用于创建注释背后的原因或意图类别的抽象基类。每个子类定义特定目的，
+        如分类、评论、描述、识别、链接或标记内容。
+    structured_aliases:
+    - literal_form: annotatiemotivatietype
+      in_language: nl
+    - literal_form: Anmerkungsmotivationstyp
+      in_language: de
+    - literal_form: type de motivation d'annotation
+      in_language: fr
+    - literal_form: tipo de motivacion de anotacion
+      in_language: es
+    - literal_form: نوع دافع التعليق التوضيحي
+      in_language: ar
+    - literal_form: tipe motivasi anotasi
+      in_language: id
+    - literal_form: 注释动机类型
+      in_language: zh
     exact_mappings:
     - oa:Motivation
-    close_mappings:
+    broad_mappings:
     - skos:Concept
     related_mappings:
     - crm:E55_Type
@@ -49,15 +95,38 @@ classes:
       has_label:
         required: true
     comments:
-    - Abstract base class - use specific subclasses (ClassifyingMotivation, etc.)
+    - Abstract base class - use specific subclasses (ClassifyingMotivation, DescribingMotivation, etc.)
     - Represents MOTIVATION TYPES, not individual motivation instances
     - Aligns with W3C Web Annotation oa:Motivation class
-    - Heritage-specific extensions beyond W3C standard motivations
+    - oa:Motivation is a subclass of skos:Concept in the W3C model
+    - Heritage-specific extensions beyond W3C standard motivations include AccessibilityMotivation, DiscoveryMotivation, PreservationMotivation, ResearchMotivation
     see_also:
     - https://www.w3.org/TR/annotation-vocab/#motivation
     - https://www.w3.org/ns/oa#Motivation
-    - http://www.cidoc-crm.org/cidoc-crm/E55_Type
+    - AnnotationMotivationTypes
+    examples:
+    - value:
+        identify_as: oa:classifying
+        has_label: classifying
+        has_description: "The motivation for classifying the target"
+      description: W3C standard classifying motivation type
+    keywords:
+    - motivation
+    - intent
+    - purpose
+    - W3C Web Annotation
+    - oa:Motivation
+    - classifying
+    - commenting
+    - describing
+    - identifying
+    - tagging
+    - linking
+    - accessibility
+    - discovery
+    - preservation
+    - research
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.3"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Abstract base class aligned with W3C Web Annotation standard
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/AnnotationType.yaml

@@ -5,6 +5,8 @@ prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
   skos: http://www.w3.org/2004/02/skos/core#
+  oa: http://www.w3.org/ns/oa#
+  schema: http://schema.org/
 default_prefix: hc
 imports:
   - linkml:types
@@ -14,26 +16,90 @@ imports:
 classes:
   AnnotationType:
     class_uri: skos:Concept
-    description: 'Abstract base class for annotation types classification.
+    description: >-
-
+      Abstract base class for categorizing different kinds of supplemental
-      Provides a taxonomy for different types of annotations.
+      information attached to resources, such as comments, tags, highlights,
-
+      or corrections.
-      '
+    alt_descriptions:
+      nl: >-
+        Abstracte basisklasse voor het categoriseren van verschillende soorten
+        aanvullende informatie toegevoegd aan bronnen, zoals opmerkingen, tags,
+        markeringen of correcties.
+      de: >-
+        Abstrakte Basisklasse zur Kategorisierung verschiedener Arten von
+        Zusatzinformationen, die Ressourcen angehangt werden, wie Kommentare,
+        Tags, Hervorhebungen oder Korrekturen.
+      fr: >-
+        Classe de base abstraite pour categoriser differents types d'informations
+        supplementaires jointes aux ressources, comme les commentaires, balises,
+        mises en evidence ou corrections.
+      es: >-
+        Clase base abstracta para categorizar diferentes tipos de informacion
+        adicional adjunta a los recursos, como comentarios, etiquetas,
+        resaltados o correcciones.
+      ar: >-
+        فئة أساسية مجردة لتصنيف أنواع مختلفة من المعلومات الإضافية المرفقة
+        بالموارد، مثل التعليقات والعلامات والإبرازات أو التصحيحات.
+      id: >-
+        Kelas dasar abstrak untuk mengkategorikan berbagai jenis informasi tambahan
+        yang dilampirkan ke sumber daya, seperti komentar, tag, sorotan, atau koreksi.
+      zh: >-
+        用于分类附加到资源的不同类型补充信息的抽象基类，如评论、标签、高亮或更正。
+    structured_aliases:
+    - literal_form: annotatietype
+      in_language: nl
+    - literal_form: Anmerkungstyp
+      in_language: de
+    - literal_form: type d'annotation
+      in_language: fr
+    - literal_form: tipo de anotacion
+      in_language: es
+    - literal_form: نوع التعليق التوضيحي
+      in_language: ar
+    - literal_form: tipe anotasi
+      in_language: id
+    - literal_form: 注释类型
+      in_language: zh
     abstract: true
-    exact_mappings:
+    broad_mappings:
     - skos:Concept
+    related_mappings:
+    - oa:Annotation
     slots:
     - has_label
     - has_code
     - has_description
     slot_usage:
       has_code:
-#         range: string
         required: true
       has_label:
-#         range: string
         required: false
+    comments:
+    - Abstract base class - use specific subclasses (CommentAnnotation, TagAnnotation, etc.)
+    - Provides a taxonomy for annotation classification
+    - Part of W3C Web Annotation ecosystem
+    see_also:
+    - Annotation
+    - AnnotationTypes
+    examples:
+    - value:
+        has_code: comment
+        has_label: Comment
+        has_description: "A textual comment on a resource"
+      description: Comment annotation type
+    - value:
+        has_code: tag
+        has_label: Tag
+        has_description: "A keyword or tag associated with a resource"
+      description: Tag annotation type
+    keywords:
+    - annotation type
+    - comment
+    - tag
+    - highlight
+    - correction
+    - classification
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.3"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Abstract base class for annotation type taxonomy
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/AnnotationTypes.yaml

@@ -1,44 +1,248 @@
 id: https://nde.nl/ontology/hc/class/AnnotationTypes
 name: annotation_types_classes
 title: Annotation Types Classes
-description: 'Concrete subclasses for AnnotationType taxonomy.
-
-  Follows Rule 0b Type/Types naming pattern.
-
-  '
-imports:
-  - ./AnnotationType
-  - linkml:types
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
+  skos: http://www.w3.org/2004/02/skos/core#
+  oa: http://www.w3.org/ns/oa#
+  schema: http://schema.org/
 default_prefix: hc
+imports:
+  - ./AnnotationType
+  - linkml:types
 classes:
   CommentAnnotation:
     is_a: AnnotationType
     class_uri: hc:Comment
-    description: A comment on a resource.
+    description: >-
-    annotations:
+      Textual commentary or opinion added to a resource by a user or system.
-      specificity_score: 0.1
+    alt_descriptions:
-      specificity_rationale: Generic utility class/slot created during migration
+      nl: >-
-      custodian_types: '[''*'']'
+        Tekstuele toelichting of mening toegevoegd aan een bron door een gebruiker of systeem.
+      de: >-
+        Textlicher Kommentar oder Meinung, die einem Benutzer oder System hinzugefugt wurde.
+      fr: >-
+        Commentaire textuel ou opinion ajoute a une ressource par un utilisateur ou un systeme.
+      es: >-
+        Comentario textual u opinion agregado a un recurso por un usuario o sistema.
+      ar: >-
+        تعليق نصي أو رأي أضيف إلى مورد من قبل مستخدم أو نظام.
+      id: >-
+        Komentar tekstual atau pendapat yang ditambahkan ke sumber daya oleh pengguna atau sistem.
+      zh: >-
+        由用户或系统添加到资源的文本评论或意见。
+    structured_aliases:
+    - literal_form: opmerkingannotatie
+      in_language: nl
+    - literal_form: Kommentaranmerkung
+      in_language: de
+    - literal_form: annotation de commentaire
+      in_language: fr
+    - literal_form: anotacion de comentario
+      in_language: es
+    - literal_form: تعليق توضيحي
+      in_language: ar
+    - literal_form: anotasi komentar
+      in_language: id
+    - literal_form: 评论注释
+      in_language: zh
+    exact_mappings:
+    - oa:commenting
+    close_mappings:
+    - schema:Comment
+    - schema:UserComments
     broad_mappings:
     - skos:Concept
+    comments:
+    - Corresponds to oa:commenting motivation
+    - Used for scholarly notes, curatorial comments, user feedback
+    examples:
+    - value:
+        has_code: comment
+        has_label: Scholarly Note
+        has_description: "Research observation about provenance"
+      description: Scholarly comment annotation
+    keywords:
+    - comment
+    - opinion
+    - feedback
+    - scholarly note
+    annotations:
+      specificity_score: "0.4"
+      specificity_rationale: Concrete annotation type for comments
+      custodian_types: "['*']"
   TagAnnotation:
     is_a: AnnotationType
     class_uri: hc:Tag
-    description: A tag or keyword associated with a resource.
+    description: >-
+      Keyword or label associated with a resource for categorization and discovery.
+    alt_descriptions:
+      nl: >-
+        Trefwoord of label gekoppeld aan een bron voor categorisatie en vindbaarheid.
+      de: >-
+        Schlusselwort oder Label, das einer Ressource zur Kategorisierung und Entdeckung zugeordnet ist.
+      fr: >-
+        Mot-cle ou etiquette associe a une ressource pour la categorisation et la decouverte.
+      es: >-
+        Palabra clave o etiqueta asociada con un recurso para categorizacion y descubrimiento.
+      ar: >-
+        كلمة مفتاحية أو تسمية مرتبطة بمورد للتصنيف والاكتشاف.
+      id: >-
+        Kata kunci atau label yang dikaitkan dengan sumber daya untuk kategorisasi dan penemuan.
+      zh: >-
+        与资源关联的关键词或标签，用于分类和发现。
+    structured_aliases:
+    - literal_form: tagannotatie
+      in_language: nl
+    - literal_form: Tag-Anmerkung
+      in_language: de
+    - literal_form: annotation de balise
+      in_language: fr
+    - literal_form: anotacion de etiqueta
+      in_language: es
+    - literal_form: تعليق توضيحي للوسم
+      in_language: ar
+    - literal_form: anotasi tag
+      in_language: id
+    - literal_form: 标签注释
+      in_language: zh
+    exact_mappings:
+    - oa:tagging
+    close_mappings:
+    - schema:keywords
     broad_mappings:
     - skos:Concept
+    comments:
+    - Corresponds to oa:tagging motivation
+    - Used for folksonomies, crowdsourced tagging, social tagging
+    examples:
+    - value:
+        has_code: tag
+        has_label: User Tag
+        has_description: "Community-generated keyword"
+      description: User-generated tag annotation
+    keywords:
+    - tag
+    - keyword
+    - folksonomy
+    - crowdsourcing
+    annotations:
+      specificity_score: "0.4"
+      specificity_rationale: Concrete annotation type for tags
+      custodian_types: "['*']"
   Highlight:
     is_a: AnnotationType
     class_uri: hc:Highlight
-    description: A highlighted segment of a resource.
+    description: >-
+      Marked segment of a resource for emphasis or later reference.
+    alt_descriptions:
+      nl: >-
+        Gemarkeerd segment van een bron voor nadruk of latere verwijzing.
+      de: >-
+        Markiertes Segment einer Ressource zur Hervorhebung oder spateren Referenz.
+      fr: >-
+        Segment mis en evidence d'une ressource pour l'emphase ou reference ulterieure.
+      es: >-
+        Segmento resaltado de un recurso para enfasis o referencia posterior.
+      ar: >-
+        جزء مميز من مورد للتأكيد أو المرجعية اللاحقة.
+      id: >-
+        Segmen yang disorot dari sumber daya untuk penekanan atau referensi nanti.
+      zh: >-
+        资源中标记的片段，用于强调或后续参考。
+    structured_aliases:
+    - literal_form: markeringannotatie
+      in_language: nl
+    - literal_form: Hervorhebungs-Anmerkung
+      in_language: de
+    - literal_form: annotation de mise en evidence
+      in_language: fr
+    - literal_form: anotacion de resaltado
+      in_language: es
+    - literal_form: تعليق توضيحي للإبراز
+      in_language: ar
+    - literal_form: anotasi sorotan
+      in_language: id
+    - literal_form: 高亮注释
+      in_language: zh
+    close_mappings:
+    - oa:highlighting
     broad_mappings:
     - skos:Concept
+    comments:
+    - Used to mark important passages or regions
+    - Often combined with comments for explanation
+    examples:
+    - value:
+        has_code: highlight
+        has_label: Important Passage
+        has_description: "Key passage for research"
+      description: Highlighted segment annotation
+    keywords:
+    - highlight
+    - emphasis
+    - selection
+    - bookmark
+    annotations:
+      specificity_score: "0.4"
+      specificity_rationale: Concrete annotation type for highlights
+      custodian_types: "['*']"
   Correction:
     is_a: AnnotationType
     class_uri: hc:Correction
-    description: A correction to a resource.
+    description: >-
+      Suggested or applied fix to errors in a resource's metadata or content.
+    alt_descriptions:
+      nl: >-
+        Voorgestelde of toegepaste correctie van fouten in de metadata of inhoud van een bron.
+      de: >-
+        Vorgeschlagene oder angewandte Korrektur von Fehlern in den Metadaten oder Inhalten einer Ressource.
+      fr: >-
+        Correction proposee ou appliquee des erreurs dans les metadonnees ou le contenu d'une ressource.
+      es: >-
+        Correccion propuesta o aplicada de errores en los metadatos o contenido de un recurso.
+      ar: >-
+        تصحيح مقترح أو مطبق للأخطاء في البيانات الوصفية أو محتوى مورد.
+      id: >-
+        Koreksi yang diusulkan atau diterapkan untuk kesalahan dalam metadata atau konten sumber daya.
+      zh: >-
+        对资源元数据或内容中错误的建议或已应用的修正。
+    structured_aliases:
+    - literal_form: correctieannotatie
+      in_language: nl
+    - literal_form: Korrektur-Anmerkung
+      in_language: de
+    - literal_form: annotation de correction
+      in_language: fr
+    - literal_form: anotacion de correccion
+      in_language: es
+    - literal_form: تعليق توضيحي للتصحيح
+      in_language: ar
+    - literal_form: anotasi koreksi
+      in_language: id
+    - literal_form: 更正注释
+      in_language: zh
+    close_mappings:
+    - oa:editing
     broad_mappings:
     - skos:Concept
+    comments:
+    - Used for crowdsourced corrections and metadata improvements
+    - May require review before application
+    examples:
+    - value:
+        has_code: correction
+        has_label: Metadata Correction
+        has_description: "Suggested fix for date error"
+      description: Metadata correction annotation
+    keywords:
+    - correction
+    - fix
+    - edit
+    - improvement
+    - crowdsourcing
+    annotations:
+      specificity_score: "0.4"
+      specificity_rationale: Concrete annotation type for corrections
+      custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/Any.yaml

@@ -1,16 +1,79 @@
 id: https://nde.nl/ontology/hc/class/Any
 name: Any
+title: Any Class
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
   owl: http://www.w3.org/2002/07/owl#
+  rdfs: http://www.w3.org/2000/01/rdf-schema#
+  skos: http://www.w3.org/2004/02/skos/core#
+default_prefix: hc
 imports:
   - linkml:types
 classes:
   Any:
     class_uri: owl:Thing
-    description: "A generic class representing any entity or literal. Used as a root or wildcard range."
+    description: >-
+      Universal root class representing any entity or literal value.
+      Used as a wildcard range when slot values can be of any type.
+    alt_descriptions:
+      nl: >-
+        Universele basisklasse die elke entiteit of letterlijke waarde vertegenwoordigt.
+        Gebruikt als wildcard-bereik wanneer slotwaarden van elk type kunnen zijn.
+      de: >-
+        Universelle Basisklasse, die jede Entitat oder jeden Literalwert darstellt.
+        Wird als Wildcard-Bereich verwendet, wenn Slot-Werte von jedem Typ sein konnen.
+      fr: >-
+        Classe racine universelle representant n'importe quelle entite ou valeur litterale.
+        Utilisee comme plage generique lorsque les valeurs de slot peuvent etre de n'importe quel type.
+      es: >-
+        Clase raiz universal que representa cualquier entidad o valor literal.
+        Se utiliza como rango comodin cuando los valores de slot pueden ser de cualquier tipo.
+      ar: >-
+        فئة جذر عالمية تمثل أي كيان أو قيمة حرفية.
+        تُستخدم كنطاق حرف بدل عندما يمكن أن تكون قيم الفتحة من أي نوع.
+      id: >-
+        Kelas akar universal yang mewakili entitas atau nilai literal apa pun.
+        Digunakan sebagai rentang wildcard ketika nilai slot dapat berupa tipe apa pun.
+      zh: >-
+        通用根类，表示任何实体或字面值。
+        当槽值可以是任何类型时用作通配符范围。
+    structured_aliases:
+    - literal_form: elk
+      in_language: nl
+    - literal_form: beliebig
+      in_language: de
+    - literal_form: tout
+      in_language: fr
+    - literal_form: cualquiera
+      in_language: es
+    - literal_form: أي
+      in_language: ar
+    - literal_form: apapun
+      in_language: id
+    - literal_form: 任意
+      in_language: zh
+    exact_mappings:
+    - owl:Thing
+    - rdfs:Resource
+    comments:
+    - Universal root class in OWL/RDF semantics
+    - Use sparingly - prefer specific types when possible
+    - Useful for polymorphic slot ranges
+    see_also:
+    - https://www.w3.org/TR/owl2-syntax/#Class_Expressions
+    examples:
+    - value: "any string value"
+      description: Any string is valid
+    - value: 42
+      description: Any number is valid
+    keywords:
+    - universal
+    - root
+    - wildcard
+    - polymorphic
+    - any type
     annotations:
-      specificity_score: 0.0
+      specificity_score: "0.0"
-      specificity_rationale: Universal root class
+      specificity_rationale: Universal root class - no specificity
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/Appellation.yaml

@@ -11,6 +11,7 @@ prefixes:
   rdfs: http://www.w3.org/2000/01/rdf-schema#
   dcterms: http://purl.org/dc/terms/
   rdf: http://www.w3.org/1999/02/22-rdf-syntax-ns#
+default_prefix: hc
 imports:
   - linkml:types
   - ../enums/AppellationTypeEnum
@@ -20,27 +21,90 @@ imports:
 classes:
   CustodianAppellation:
     class_uri: crm:E41_Appellation
-    description: "An alternative name or label variant for a CustodianName.\nCustodianAppellation represents names that are NOT the most common emic \ndesignator but are still used to refer to the custodian.\n\nCRITICAL: CustodianAppellations are linked to CustodianName (NOT directly to Custodian).\nOnly CustodianIdentifier can identify the Custodian hub.\n\nCIDOC-CRM E41_Appellation: Any identifier expressed as text (names, titles, labels).\nSKOS: altLabel for alternative lexical labels (trading names, colloquial names, abbreviations).\n\n**Use for**: \n- Alternative names and abbreviations (e.g., \"BnF\" for \"Biblioth\xE8que nationale de France\")\n- Translations and multilingual variants\n- Historical names and spelling variants\n- Colloquial/informal names\n\n**Connection Architecture**:\n- CustodianName (preferred label) \u2192 skos:altLabel \u2192 CustodianAppellation (variants)\n- Enables multiple variant appellations per canonical name\n\n**Enables**:\n- Multilingual name representation\
+    description: >-
-      \ (via appellation_language)\n- Name type classification (official, vernacular, historical, translation)\n- Relationship to naming authority\n- Temporal validity (when name was used)\n"
+      Alternative name or label variant for a heritage custodian institution,
+      including abbreviations, translations, historical names, and colloquial forms.
+    alt_descriptions:
+      nl: >-
+        Alternatieve naam of labelvariant voor een erfgoedbewaarderinstelling,
+        inclusief afkortingen, vertalingen, historische namen en volksnamen.
+      de: >-
+        Alternativer Name oder Bezeichnungsvariante fur eine Kulturerbe-Verwahrerinstitution,
+        einschliesslich Abkurzungen, Ubersetzungen, historischer Namen und umgangssprachlicher Formen.
+      fr: >-
+        Nom alternatif ou variante d'etiquette pour une institution deprepositaire
+        du patrimoine, y compris les abreviations, traductions, noms historiques et formes familiers.
+      es: >-
+        Nombre alternativo o variante de etiqueta para una institucion depositaria
+        del patrimonio, incluyendo abreviaturas, traducciones, nombres historicos y formas coloquiales.
+      ar: >-
+        اسم بديل أو متغير التسمية لمؤسسة حارسة للتراث، بما في ذلك الاختصارات
+        والترجمات والأسماء التاريخية والأشكال العامية.
+      id: >-
+        Nama alternatif atau varian label untuk lembaga penjaka warisan budaya,
+        termasuk singkatan, terjemahan, nama historis, dan bentuk sehari-hari.
+      zh: >-
+        遗产保管机构的替代名称或标签变体，包括缩写、翻译、历史名称和通俗形式。
+    structured_aliases:
+    - literal_form: bewaardersbenaming
+      in_language: nl
+    - literal_form: Verwahrer-Bezeichnung
+      in_language: de
+    - literal_form: appellation de depositeur
+      in_language: fr
+    - literal_form: apelacion de depositario
+      in_language: es
+    - literal_form: تسمية الحارس
+      in_language: ar
+    - literal_form: sebutan penjaga
+      in_language: id
+    - literal_form: 保管者名称
+      in_language: zh
     exact_mappings:
     - crm:E41_Appellation
     close_mappings:
-    - skos:Concept
     - schema:name
     - foaf:name
     - rdfs:label
     - dcterms:title
+    - skos:altLabel
+    broad_mappings:
+    - skos:Concept
     slots:
     - has_score
     - alternative_form_of
     slot_usage:
       alternative_form_of:
-#         range: string # uriorcurie
+        inlined: false
-        # range: Label
-        inlined: false # Fixed invalid inline for primitive type
         examples:
         - value: "Label:\n  label_value: \"Rijksmuseum\"\n  label_language: \"nl\"\n"
+    comments:
+    - Represents names that are NOT the most common emic designator
+    - Linked to CustodianName (NOT directly to Custodian)
+    - Enables multilingual name representation via appellation_language
+    - Supports name type classification (official, vernacular, historical, translation)
+    see_also:
+    - CustodianName
+    - AppellationType
+    - http://www.cidoc-crm.org/cidoc-crm/E41_Appellation
+    examples:
+    - value:
+        alternative_form_of: "Bibliotheque nationale de France"
+        has_score: 0.95
+      description: Abbreviated appellation "BnF" for the French National Library
+    - value:
+        alternative_form_of: "Koninklijke Bibliotheek"
+        has_score: 0.9
+      description: Abbreviated appellation "KB" for the Dutch National Library
+    keywords:
+    - alternative name
+    - abbreviation
+    - translation
+    - historical name
+    - colloquial name
+    - variant
+    - alias
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.4"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Specific to custodian name variants
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/AppellationType.yaml

@@ -1,25 +1,103 @@
 id: https://nde.nl/ontology/hc/class/AppellationType
 name: AppellationType
-title: Appellation Type
+title: Appellation Type Class
-description: Type of appellation/name.
 prefixes:
   linkml: https://w3id.org/linkml/
+  hc: https://nde.nl/ontology/hc/
   schema: http://schema.org/
   skos: http://www.w3.org/2004/02/skos/core#
+  crm: http://www.cidoc-crm.org/cidoc-crm/
   rico: https://www.ica.org/standards/RiC/ontology#
-  wd: http://www.wikidata.org/entity/
+default_prefix: hc
 imports:
   - linkml:types
   - ../slots/has_label
+  - ../slots/has_description
 classes:
   AppellationType:
     class_uri: skos:Concept
-    exact_mappings:
+    description: >-
-      - crm:E55_Type
+      Category for classifying different kinds of names or designations
-    description: Type of appellation/name.
+      applied to entities, such as official names, vernacular names,
+      historical names, abbreviations, or translations.
+    alt_descriptions:
+      nl: >-
+        Categorie voor het classificeren van verschillende soorten namen of
+        aanduidingen toegepast op entiteiten, zoals officiële namen, volksnamen,
+        historische namen, afkortingen of vertalingen.
+      de: >-
+        Kategorie zur Klassifizierung verschiedener Arten von Namen oder
+        Bezeichnungen, die auf Entitaten angewendet werden, wie offizielle Namen,
+        volkssprachliche Namen, historische Namen, Abkurzungen oder Ubersetzungen.
+      fr: >-
+        Categorie pour classer differents types de noms ou designations appliques
+        aux entites, tels que noms officiels, noms vernaculaires, noms historiques,
+        abreviations ou traductions.
+      es: >-
+        Categoria para clasificar diferentes tipos de nombres o designaciones
+        aplicados a entidades, como nombres oficiales, nombres vernaculos,
+        nombres historicos, abreviaturas o traducciones.
+      ar: >-
+        فئة لتصنيف أنواع مختلفة من الأسماء أو التسميات المطبقة على الكيانات،
+        مثل الأسماء الرسمية والأسماء العامية والأسماء التاريخية والاختصارات أو الترجمات.
+      id: >-
+        Kategori untuk mengklasifikasikan berbagai jenis nama atau sebutan yang
+        diterapkan pada entitas, seperti nama resmi, nama vernakular, nama historis,
+        singkatan, atau terjemahan.
+      zh: >-
+        用于分类应用于实体的不同类型名称或称谓的类别，如官方名称、俗名、
+        历史名称、缩写或翻译。
+    structured_aliases:
+    - literal_form: benamingtype
+      in_language: nl
+    - literal_form: Bezeichnungstyp
+      in_language: de
+    - literal_form: type d'appellation
+      in_language: fr
+    - literal_form: tipo de apelacion
+      in_language: es
+    - literal_form: نوع التسمية
+      in_language: ar
+    - literal_form: tipe sebutan
+      in_language: id
+    - literal_form: 名称类型
+      in_language: zh
+    broad_mappings:
+    - crm:E55_Type
+    - skos:Concept
     slots:
     - has_label
+    - has_description
+    slot_usage:
+      has_label:
+        required: true
+      has_description:
+        required: false
+    comments:
+    - Abstract classification for name types
+    - Examples: official, vernacular, historical, translation, abbreviation
+    - Used with CustodianAppellation for name variant typing
+    see_also:
+    - CustodianAppellation
+    - http://www.cidoc-crm.org/cidoc-crm/E55_Type
+    examples:
+    - value:
+        has_label: "Official Name"
+        has_description: "The legally recognized name of an entity"
+      description: Official name appellation type
+    - value:
+        has_label: "Abbreviation"
+        has_description: "Shortened form of a name"
+      description: Abbreviation appellation type
+    keywords:
+    - appellation type
+    - name type
+    - official name
+    - vernacular name
+    - historical name
+    - abbreviation
+    - translation
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.3"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Abstract type classification for appellations
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/Applicant.yaml

@@ -6,9 +6,9 @@ prefixes:
   hc: https://nde.nl/ontology/hc/
   schema: http://schema.org/
   skos: http://www.w3.org/2004/02/skos/core#
-
+  foaf: http://xmlns.com/foaf/0.1/
+  prov: http://www.w3.org/ns/prov#
 default_prefix: hc
-
 imports:
   - linkml:types
   - ../metadata
@@ -17,20 +17,90 @@ imports:
   - ../slots/has_type
 classes:
   Applicant:
-    class_uri: schema:Person
+    class_uri: hc:Applicant
     description: >-
-      An individual or organization applying for a grant, job, or opportunity.
+      Individual or organization submitting a formal request for access,
-      
+      funding, employment, or other opportunities within heritage institution contexts.
-      **Ontology Alignment**:
+    alt_descriptions:
-      - **Primary**: `schema:Person` or `schema:Organization`
+      nl: >-
-      - **Close**: `foaf:Agent`
+        Individu of organisatie dat een formeel verzoek indient voor toegang,
-    
+        financiering, werkgelegenheid of andere mogelijkheden binnen de context
+        van erfgoedinstellingen.
+      de: >-
+        Individuum oder Organisation, das einen formellen Antrag fur Zugang,
+        Finanzierung, Beschaftigung oder andere Moglichkeiten im Kontext von
+        Kulturerbeinstitutionen einreicht.
+      fr: >-
+        Individu ou organisation soumettant une demande formelle d'acces,
+        de financement, d'emploi ou d'autres opportunites dans le contexte
+        des institutions patrimoniales.
+      es: >-
+        Individuo u organizacion que presenta una solicitud formal de acceso,
+        financiamiento, empleo u otras oportunidades en el contexto de
+        instituciones patrimoniales.
+      ar: >-
+        فرد أو منظمة تقدم طلبًا رسميًا للوصول أو التمويل أو التوظيف أو
+        الفرص الأخرى في سياق مؤسسات التراث.
+      id: >-
+        Individu atau organisasi yang mengajukan permintaan formal untuk akses,
+        pendanaan, pekerjaan, atau peluang lain dalam konteks lembaga warisan budaya.
+      zh: >-
+        在遗产机构背景下提交访问、资助、就业或其他机会正式请求的个人或组织。
+    structured_aliases:
+    - literal_form: aanvrager
+      in_language: nl
+    - literal_form: Antragsteller
+      in_language: de
+    - literal_form: demandeur
+      in_language: fr
+    - literal_form: solicitante
+      in_language: es
+    - literal_form: مقدم الطلب
+      in_language: ar
+    - literal_form: pemohon
+      in_language: id
+    - literal_form: 申请人
+      in_language: zh
+    broad_mappings:
+    - schema:Person
+    - schema:Organization
+    - foaf:Agent
+    - prov:Agent
     slots:
-      - has_label
+    - has_label
-      - identified_by
+    - identified_by
-      - has_type
+    - has_type
-      
+    slot_usage:
+      has_type:
+        range: ApplicantType
+        required: false
+      identified_by:
+        required: true
+    comments:
+    - Represents the requesting party in application workflows
+    - Can be either a person or an organization
+    - Linked to ApplicantType for classification (Individual, NonProfit, University, etc.)
+    see_also:
+    - ApplicantType
+    - ApplicantRequirement
+    examples:
+    - value:
+        has_label: "Dr. Jane Smith"
+        has_type: hc:IndividualApplicant
+        identified_by: "https://orcid.org/0000-0001-2345-6789"
+      description: Individual researcher applicant
+    - value:
+        has_label: "University of Amsterdam"
+        has_type: hc:UniversityApplicant
+        identified_by: "https://ror.org/020r9kr23"
+      description: Institutional applicant
+    keywords:
+    - applicant
+    - requester
+    - grant applicant
+    - job applicant
+    - access applicant
     annotations:
-      custodian_types: '["*"]'
+      specificity_score: "0.4"
-      specificity_score: 0.5
+      specificity_rationale: Role class for application contexts
-      specificity_rationale: Generic applicant role.
+      custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/ApplicantRequirement.yaml

@@ -21,10 +21,55 @@ imports:
   - ../slots/impose
 classes:
   ApplicantRequirement:
-    class_uri: schema:Requirement
+    class_uri: hc:ApplicantRequirement
-    description: 'A requirement that an applicant must fulfill (e.g., residency, organization type).
+    description: >-
-
+      Formal prerequisite or condition that must be satisfied by an applicant,
-      **Ontology Alignment**: - **Primary**: `schema:Requirement` (proposed extension or conceptual) - **Close**: `dcterms:requires`'
+      such as residency requirements, organizational type, credentials, or
+      geographic restrictions.
+    alt_descriptions:
+      nl: >-
+        Formele voorwaarde of conditie die door een aanvrager moet worden vervuld,
+        zoals verblijfsvereisten, organisatietype, referenties of geografische beperkingen.
+      de: >-
+        Formelle Voraussetzung oder Bedingung, die von einem Antragsteller erfullt
+        werden muss, wie Aufenthaltsanforderungen, Organisationstyp, Qualifikationen
+        oder geografische Beschrankungen.
+      fr: >-
+        Prerequis formel ou condition qui doit etre satisfait par un demandeur,
+        comme les conditions de residence, le type d'organisation, les references
+        ou les restrictions geographiques.
+      es: >-
+        Requisito previo formal o condicion que debe ser satisfecha por un solicitante,
+        como requisitos de residencia, tipo de organizacion, credenciales o
+        restricciones geograficas.
+      ar: >-
+        شرط مسبق رسمي أو شرط يجب أن يلبيه مقدم الطلب، مثل متطلبات الإقامة
+        أو نوع المنظمة أو بيانات الاعتماد أو القيود الجغرافية.
+      id: >-
+        Prasyarat formal atau kondisi yang harus dipenuhi oleh pemohon, seperti
+        persyaratan tempat tinggal, jenis organisasi, kredensial, atau batasan geografis.
+      zh: >-
+        申请人必须满足的正式先决条件或条件，如居住要求、组织类型、资格或地理限制。
+    structured_aliases:
+    - literal_form: aanvragervereiste
+      in_language: nl
+    - literal_form: Antragstelleranforderung
+      in_language: de
+    - literal_form: exigence du demandeur
+      in_language: fr
+    - literal_form: requisito del solicitante
+      in_language: es
+    - literal_form: متطلب مقدم الطلب
+      in_language: ar
+    - literal_form: persyaratan pemohon
+      in_language: id
+    - literal_form: 申请人要求
+      in_language: zh
+    close_mappings:
+    - schema:Requirement
+    - dcterms:requires
+    broad_mappings:
+    - skos:Concept
     slots:
     - has_description
     - fulfilled_by
@@ -34,7 +79,31 @@ classes:
         range: Applicant
       impose:
         range: GeographicExtent
+    comments:
+    - Defines eligibility criteria for applications
+    - Can be linked to geographic extent via impose slot
+    - Used in grant, access, and employment application workflows
+    see_also:
+    - Applicant
+    - ApplicantType
+    examples:
+    - value:
+        has_description: "Applicant must be a registered non-profit organization in the European Union"
+        impose:
+          geographic_scope: "EU"
+      description: Non-profit requirement with EU geographic restriction
+    - value:
+        has_description: "Applicant must hold a valid research affiliation"
+        fulfilled_by: "ResearchInstitution"
+      description: Institutional affiliation requirement
+    keywords:
+    - requirement
+    - prerequisite
+    - eligibility
+    - residency
+    - credential
+    - geographic restriction
     annotations:
-      custodian_types: '["*"]'
+      specificity_score: "0.5"
-      specificity_score: 0.6
+      specificity_rationale: Specific to applicant eligibility criteria
-      specificity_rationale: Requirements for applications.
+      custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/ApplicantType.yaml

@@ -6,9 +6,7 @@ prefixes:
   hc: https://nde.nl/ontology/hc/
   schema: http://schema.org/
   skos: http://www.w3.org/2004/02/skos/core#
-
 default_prefix: hc
-
 imports:
   - linkml:types
   - ../metadata
@@ -18,17 +16,94 @@ classes:
   ApplicantType:
     class_uri: skos:Concept
     description: >-
-      Type classification for an applicant (e.g. Individual, NonProfit, University).
+      Category for classifying applicants by their organizational or individual
-      
+      status, such as Individual, NonProfit, University, Commercial, or
-      **Ontology Alignment**:
+      Government entity.
-      - **Primary**: `skos:Concept`
+    alt_descriptions:
-      - **Close**: `schema:definedTerm`
+      nl: >-
-    
+        Categorie voor het classificeren van aanvragers op basis van hun
+        organisatorische of individuele status, zoals Individu, NonProfit,
+        Universiteit, Commercieel of Overheidsinstantie.
+      de: >-
+        Kategorie zur Klassifizierung von Antragstellern nach ihrem organisatorischen
+        oder individuellen Status, wie Individuum, NonProfit, Universitat,
+        Kommerziell oder Behorde.
+      fr: >-
+        Categorie pour classer les demandeurs selon leur statut organisationnel
+        ou individuel, comme Individu, Association a but non lucratif, Universite,
+        Commercial ou Entite gouvernementale.
+      es: >-
+        Categoria para clasificar a los solicitantes por su estatus organizacional
+        o individual, como Individual, Sin fines de lucro, Universidad, Comercial
+        o Entidad gubernamental.
+      ar: >-
+        فئة لتصنيف مقدمي الطلبات حسب وضعهم التنظيمي أو الفردي، مثل فرد أو
+        غير ربحي أو جامعة أو تجاري أو كيان حكومي.
+      id: >-
+        Kategori untuk mengklasifikasikan pemohon berdasarkan status organisasi
+        atau individu mereka, seperti Individu, Nirlaba, Universitas, Komersial,
+        atau Entitas Pemerintah.
+      zh: >-
+        按组织或个人身份对申请人进行分类的类别，如个人、非营利、大学、商业或政府实体。
+    structured_aliases:
+    - literal_form: aanvragerstype
+      in_language: nl
+    - literal_form: Antragstellertyp
+      in_language: de
+    - literal_form: type de demandeur
+      in_language: fr
+    - literal_form: tipo de solicitante
+      in_language: es
+    - literal_form: نوع مقدم الطلب
+      in_language: ar
+    - literal_form: tipe pemohon
+      in_language: id
+    - literal_form: 申请人类型
+      in_language: zh
+    close_mappings:
+    - schema:definedTerm
+    broad_mappings:
+    - skos:Concept
     slots:
-      - has_label
+    - has_label
-      - identified_by
+    - identified_by
-      
+    slot_usage:
+      has_label:
+        required: true
+        equals_string_in:
+        - "Individual"
+        - "NonProfit"
+        - "University"
+        - "Commercial"
+        - "Government"
+        - "ResearchInstitute"
+      identified_by:
+        required: true
+    comments:
+    - Abstract classification for applicant categories
+    - Used to determine eligibility and fee structures
+    - Linked to Applicant instances via has_type slot
+    see_also:
+    - Applicant
+    - ApplicantRequirement
+    examples:
+    - value:
+        has_label: "Individual"
+        identified_by: "hc:IndividualApplicant"
+      description: Individual person applicant type
+    - value:
+        has_label: "University"
+        identified_by: "hc:UniversityApplicant"
+      description: Higher education institution applicant type
+    keywords:
+    - applicant type
+    - individual
+    - non-profit
+    - university
+    - commercial
+    - government
+    - classification
     annotations:
-      custodian_types: '["*"]'
+      specificity_score: "0.4"
-      specificity_score: 0.7
+      specificity_rationale: Type classification for applicant categories
-      specificity_rationale: Classification for applicants.
+      custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/Appointment.yaml

@@ -1,37 +1,73 @@
 id: https://nde.nl/ontology/hc/class/Appointment
 name: appointment_class
 title: Appointment Class
-version: 1.0.0
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
   schema: http://schema.org/
   rico: https://www.ica.org/standards/RiC/ontology#
+  skos: http://www.w3.org/2004/02/skos/core#
+default_prefix: hc
 imports:
   - linkml:types
   - ../slots/has_description
   - ../slots/has_label
   - ../slots/temporal_extent
-default_prefix: hc
 classes:
   Appointment:
     class_uri: schema:Reservation
-    description: "Models an appointment or reservation requirement as a structured\
+    description: >-
-      \ entity.\n\n**PURPOSE**:\nHeritage institutions often require appointments\
+      Scheduled arrangement for accessing heritage collections or services,
-      \ for:\n- Special collections access\n- Reading room reservations  \n- Guided\
+      capturing lead time requirements, booking methods, confirmation needs,
-      \ tours of sensitive materials\n- Conservation viewing requests\n\nBy modeling\
+      and cancellation policies.
-      \ appointments as entities (not just boolean flags), we can capture:\n- Lead\
+    alt_descriptions:
-      \ time requirements (24h, 48h, 1 week in advance)\n- Booking methods (email,\
+      nl: >-
-      \ phone, online form)\n- Confirmation requirements\n- Cancellation policies\n\
+        Geplande regeling voor toegang tot erfgoedcollecties of -diensten,
-      - Temporal validity (when appointments are required)\n\n**ONTOLOGY ALIGNMENT**:\n\
+        waarbij doorlooptijdvereisten, boekingsmethoden, bevestigingsbehoeften
-      - schema:Reservation - \"A reservation for an event, service, or product\"\n\
+        en annuleringsbeleid worden vastgelegd.
-      - rico:conditionsOfAccess - Links to RiC-O access condition patterns\n\n**REPLACES**:\n\
+      de: >-
-      - appointment_required (boolean) - Now modeled as structured entity\n- requires_appointment\
+        Geplante Vereinbarung fur den Zugang zu Kulturerbesammlungen oder -diensten,
-      \ (boolean) - Preserved for backward compatibility\n"
+        die Vorlaufzeitanforderungen, Buchungsmethoden, Bestatigungsbedarfe und
+        Stornierungsrichtlinien erfasst.
+      fr: >-
+        Arrangement planifie pour l'acces aux collections ou services patrimoniaux,
+        capturant les delais d'anticipation, les methodes de reservation, les besoins
+        de confirmation et les politiques d'annulation.
+      es: >-
+        Arreglo programado para acceder a colecciones o servicios patrimoniales,
+        capturando requisitos de tiempo de anticipacion, metodos de reserva,
+        necesidades de confirmacion y politicas de cancelacion.
+      ar: >-
+        ترتيب مجدول للوصول إلى مجموعات أو خدمات التراث، يلتقط متطلبات الوقت
+        المسبق وطرق الحجز ومتطلبات التأكيد وسياسات الإلغاء.
+      id: >-
+        Pengaturan terjadwal untuk mengakses koleksi atau layanan warisan budaya,
+        menangkap persyaratan waktu tunggu, metode pemesanan, kebutuhan konfirmasi,
+        dan kebijakan pembatalan.
+      zh: >-
+        访问遗产馆藏或服务的预定安排，捕获提前时间要求、预订方法、确认需求
+        和取消政策。
+    structured_aliases:
+    - literal_form: afspraak
+      in_language: nl
+    - literal_form: Termin
+      in_language: de
+    - literal_form: rendez-vous
+      in_language: fr
+    - literal_form: cita
+      in_language: es
+    - literal_form: موعد
+      in_language: ar
+    - literal_form: janji temu
+      in_language: id
+    - literal_form: 预约
+      in_language: zh
     exact_mappings:
     - schema:Reservation
     close_mappings:
     - rico:Rule
+    broad_mappings:
+    - skos:Concept
     slots:
     - has_label
     - has_description
@@ -42,26 +78,42 @@ classes:
         - value: Reading Room Appointment
         - value: Special Collections Viewing
         - value: Conservation Lab Access
+        - value: Guided Tour
       has_description:
         examples:
-        - value: "Appointments for the Special Collections reading room must be made\
+        - value: "Appointments for the Special Collections reading room must be made at least 48 hours in advance. Please specify which materials you wish to consult. Maximum 5 items per visit."
-            \ \nat least 48 hours in advance. Please specify which materials you \n\
-            wish to consult. Maximum 5 items per visit.\n"
       temporal_extent:
         range: TimeSpan
         inlined: true
+    comments:
+    - Models appointments as entities rather than boolean flags
+    - Captures lead time, booking methods, and policies
+    - Replaces simple appointment_required boolean with structured data
+    - Common for special collections, reading rooms, conservation labs
+    see_also:
+    - https://schema.org/Reservation
+    - AccessPolicy
     examples:
     - value:
-        appointment_id: hc:appointment/nationaal-archief-special-collections
         has_label: Special Collections Appointment
-        has_description: Advance appointment required for manuscript and map
+        has_description: Advance appointment required for manuscript and map collections
-          collections
+        temporal_extent:
+          begin_of_the_begin: "2025-01-15T10:00:00Z"
+          end_of_the_end: "2025-01-15T12:00:00Z"
+      description: Special collections appointment with time slot
     - value:
-        appointment_id: hc:appointment/reading-room-recommended
         has_label: Reading Room Reservation
-        has_description: Reservations recommended but walk-ins accepted based
+        has_description: Reservations recommended but walk-ins accepted based on availability
-          on availability
+      description: Reading room reservation (optional booking)
+    keywords:
+    - appointment
+    - reservation
+    - booking
+    - reading room
+    - special collections
+    - lead time
+    - cancellation
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.5"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Specific to heritage access scheduling
-      custodian_types: '[''*'']'
+      custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/AppraisalPolicy.yaml

@@ -6,24 +6,97 @@ prefixes:
   hc: https://nde.nl/ontology/hc/
   rico: https://www.ica.org/standards/RiC/ontology#
   odrl: http://www.w3.org/ns/odrl/2/
+  skos: http://www.w3.org/2004/02/skos/core#
+  dcterms: http://purl.org/dc/terms/
 default_prefix: hc
 imports:
   - linkml:types
+  - ../classes/Policy
 classes:
   AppraisalPolicy:
     is_a: Policy
     class_uri: odrl:Policy
-    description: 'A policy governing the appraisal of records or collections.
+    description: >-
-
+      Formal statement governing the evaluation and selection of records or
-
+      collections for retention, transfer, or disposal based on administrative,
-      **Ontological Alignment**:
+      legal, fiscal, and historical value criteria.
-
+    alt_descriptions:
-      - `odrl:Policy`: Policy representing rules.
+      nl: >-
-
+        Formele verklaring die de evaluatie en selectie van archiefstukken of
-      - `rico:Rule`: Rule governing management.
+        collecties voor behoud, overdracht of vernietiging regelt op basis van
-
+        administratieve, juridische, fiscale en historische waardecriteria.
-      '
+      de: >-
+        Formelle Erklarung, die die Bewertung und Auswahl von Unterlagen oder
+        Sammlungen zur Aufbewahrung, Ubertragung oder Vernichtung auf der Grundlage
+        von administrativen, rechtlichen, steuerlichen und historischen Wertkriterien regelt.
+      fr: >-
+        Declaration formelle regissant l'evaluation et la selection des documents
+        ou collections pour la retention, le transfert ou l'elimination sur la base
+        de criteres de valeur administrative, juridique, fiscale et historique.
+      es: >-
+        Declaracion formal que rige la evaluacion y seleccion de registros o
+        colecciones para retencion, transferencia o eliminacion basada en criterios
+        de valor administrativo, legal, fiscal e historico.
+      ar: >-
+        بيان رسمي يحكم تقييم واختيار السجلات أو المجموعات للاحتفاظ بها أو
+        نقلها أو التخلص منها بناءً على معايير القيمة الإدارية والقانونية
+        والمالية والتاريخية.
+      id: >-
+        Pernyataan formal yang mengatur evaluasi dan seleksi rekaman atau koleksi
+        untuk penyimpanan, transfer, atau pemusnahan berdasarkan kriteria nilai
+        administratif, hukum, fiskal, dan historis.
+      zh: >-
+        管理基于行政、法律、财政和历史价值标准对记录或馆藏进行评估和选择
+        以进行保留、转移或处置的正式声明。
+    structured_aliases:
+    - literal_form: beoordelingsbeleid
+      in_language: nl
+    - literal_form: Bewertungspolitik
+      in_language: de
+    - literal_form: politique d'evaluation
+      in_language: fr
+    - literal_form: politica de evaluacion
+      in_language: es
+    - literal_form: سياسة التقييم
+      in_language: ar
+    - literal_form: kebijakan penilaian
+      in_language: id
+    - literal_form: 鉴定政策
+      in_language: zh
+    exact_mappings:
+    - odrl:Policy
+    close_mappings:
+    - rico:Rule
+    - dcterms:accessRights
+    broad_mappings:
+    - skos:Concept
+    comments:
+    - Core archival function for records management
+    - Based on primary value (administrative, legal, fiscal) and secondary value (historical, research)
+    - Follows archival appraisal standards and retention schedules
+    - Part of Policy hierarchy in heritage custodianship
+    see_also:
+    - Policy
+    - AcquisitionMethod
+    - https://www.ica.org/standards/RiC/ontology
+    examples:
+    - value:
+        has_label: "University Records Appraisal Policy"
+        has_description: "Policy governing retention of administrative and academic records"
+      description: University-wide appraisal policy
+    - value:
+        has_label: "Faculty Papers Appraisal Policy"
+        has_description: "Criteria for evaluating faculty archives for permanent retention"
+      description: Faculty papers appraisal criteria
+    keywords:
+    - appraisal
+    - records management
+    - retention
+    - disposal
+    - archival value
+    - selection criteria
+    - retention schedule
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.5"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Specific to archival appraisal governance
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/AppreciationEvent.yaml

@@ -7,40 +7,75 @@ prefixes:
   schema: http://schema.org/
   as: https://www.w3.org/ns/activitystreams#
   prov: http://www.w3.org/ns/prov#
+  skos: http://www.w3.org/2004/02/skos/core#
+default_prefix: hc
 imports:
   - linkml:types
   - ../metadata
   - ../slots/has_quantity
   - ../slots/has_measurement_unit
   - ../slots/temporal_extent
-default_prefix: hc
 classes:
   AppreciationEvent:
     class_uri: as:Like
-    description: "Appreciation or engagement event for digital content.\n\n**PURPOSE**:\n\
+    description: >-
-      \nStructured representation of appreciation metrics (likes, favorites,\nupvotes,\
+      Structured representation of engagement metrics such as likes, favorites,
-      \ reactions) for digital content such as videos, comments, and posts.\nReplaces\
+      upvotes, reactions, or shares for digital content, replacing simple
-      \ simple integer counts with rich event data.\n\n**DESIGN RATIONALE**:\n\nCreated\
+      integer counts with rich event data including temporal observation.
-      \ per slot_fixes.yaml migration from `comment_like_count` integer\nto structured\
+    alt_descriptions:
-      \ `appreciated` + `AppreciationEvent` with\n`has_quantity`\
+      nl: >-
-      \ + `Quantity` for metric representation.\n\n**APPRECIATION TYPES**:\n\n| Type\
+        Gestructureerde weergave van betrokkenheidsstatistieken zoals likes,
-      \ | Description | Platforms |\n|------|-------------|-----------|\n| like |\
+        favorieten, stemmen, reacties of shares voor digitale content, ter
-      \ Standard like/thumbs up | YouTube, Facebook, Instagram |\n| favorite | Favorite/bookmark\
+        vervanging van eenvoudige gehele getallen met rijke gebeurtenisgegevens
-      \ | Twitter, YouTube |\n| upvote | Upvote/positive rating | Reddit, StackOverflow\
+        inclusief temporele observatie.
-      \ |\n| reaction | Emoji reaction | Facebook, Slack |\n| share | Share/repost\
+      de: >-
-      \ | All platforms |\n\n**ONTOLOGY ALIGNMENT**:\n\n| Ontology | Class/Property\
+        Strukturierte Darstellung von Engagement-Metriken wie Likes, Favoriten,
-      \ | Usage |\n|----------|----------------|-------|\n| **Activity Streams** |\
+        Upvotes, Reaktionen oder Shares fur digitale Inhalte, die einfache
-      \ `as:Like` | Social appreciation activity |\n| **Schema.org** | `schema:InteractionCounter`\
+        Ganzzahlen durch umfangreiche Ereignisdaten mit zeitlicher Beobachtung ersetzt.
-      \ | Engagement metrics |\n| **PROV-O** | `prov:Activity` | Event modeling |\n\
+      fr: >-
-      \n**EXAMPLE**:\n\n```yaml\nappreciated:\n  - appreciation_type: like\n\
+        Representation structuree des metriques d'engagement telles que les likes,
-      \    has_quantity:\n      numeric_value: 42\n      has_unit:\n\
+        favoris, votes positifs, reactions ou partages pour le contenu numerique,
-      \        unit_label: \"likes\"\n    temporal_extent:\n      begin_of_the_begin:\
+        remplaçant les simples comptes entiers par des donnees d'evenement riches
-      \ \"2025-01-14T10:00:00Z\"\n```\n"
+        incluant l'observation temporelle.
+      es: >-
+        Representacion estructurada de metricas de compromiso como me gusta,
+        favoritos, votos positivos, reacciones o compartidos para contenido digital,
+        reemplazando simples conteos enteros con datos de eventos ricos que incluyen
+        observacion temporal.
+      ar: >-
+        تمثيل منظم لمقاييس المشاركة مثل الإعجابات والمفضلات والأصوات الإيجابية
+        والتفاعلات أو المشاركات للمحتوى الرقمي، بدلاً من الأعداد الصحيحة البسيطة
+        ببيانات أحداث غنية تتضمن الملاحظة الزمنية.
+      id: >-
+        Representasi terstruktur dari metrik keterlibatan seperti suka, favorit,
+        voting positif, reaksi, atau berbagi untuk konten digital, menggantikan
+        jumlah bilangan bulat sederhana dengan data peristiwa yang kaya termasuk
+        observasi temporal.
+      zh: >-
+        数字内容参与度指标的结构化表示，如点赞、收藏、投票、反应或分享，
+        用包含时间观察的丰富事件数据替代简单的整数计数。
+    structured_aliases:
+    - literal_form: waarderingsgebeurtenis
+      in_language: nl
+    - literal_form: Wertschatzungsereignis
+      in_language: de
+    - literal_form: evenement d'appreciation
+      in_language: fr
+    - literal_form: evento de apreciacion
+      in_language: es
+    - literal_form: حدث التقدير
+      in_language: ar
+    - literal_form: peristiwa apresiasi
+      in_language: id
+    - literal_form: 欣赏事件
+      in_language: zh
     exact_mappings:
     - as:Like
     close_mappings:
     - schema:InteractionCounter
+    broad_mappings:
     - prov:Activity
+    - skos:Concept
     slots:
     - has_quantity
     - has_measurement_unit
@@ -48,7 +83,7 @@ classes:
     slot_usage:
       has_quantity:
         range: integer
-        inlined: false # Fixed invalid inline for primitive type
+        inlined: false
         required: false
         examples:
         - value:
@@ -56,8 +91,7 @@ classes:
             has_measurement_unit:
               unit_label: likes
       has_measurement_unit:
-#         range: string
+        inlined: false
-        inlined: false # Fixed invalid inline for primitive type
         required: false
         examples:
         - value:
@@ -68,29 +102,41 @@ classes:
         required: false
         examples:
         - value:
-            begin_of_the_begin: '2025-01-14T10:00:00Z'
+            begin_of_the_begin: "2025-01-14T10:00:00Z"
-    examples:
-    - value: null
-    - value:
-        has_quantity:
-          numeric_value: 42
-          has_unit:
-            unit_label: likes
-        temporal_extent:
-          begin_of_the_begin: '2025-01-14T10:00:00Z'
-    - value: null
     comments:
-    - Created 2026-01-22 from comment_like_count migration (Rule 53)
+    - Created 2026-01-22 from comment_like_count migration
     - Models appreciation metrics as structured events
-    - Supports multiple appreciation types (likes, favorites, etc.)
+    - Supports multiple appreciation types (likes, favorites, upvotes, reactions, shares)
-    - Includes temporal observation tracking
+    - Includes temporal observation tracking for analytics
     see_also:
     - https://www.w3.org/ns/activitystreams#Like
     - https://schema.org/InteractionCounter
+    examples:
+    - value:
+        has_quantity: 42
+        has_measurement_unit:
+          unit_label: likes
+        temporal_extent:
+          begin_of_the_begin: "2025-01-14T10:00:00Z"
+      description: YouTube-style like count with observation timestamp
+    - value:
+        has_quantity: 128
+        has_measurement_unit:
+          unit_label: upvotes
+        temporal_extent:
+          begin_of_the_begin: "2025-01-15T14:30:00Z"
+      description: Reddit-style upvote count
+    keywords:
+    - appreciation
+    - likes
+    - favorites
+    - upvotes
+    - reactions
+    - shares
+    - engagement metrics
+    - social media
+    - interaction counter
     annotations:
-      custodian_types: '["*"]'
+      specificity_score: "0.5"
-      custodian_types_rationale: Universal - any custodian with digital content may
+      specificity_rationale: Specific to digital content engagement metrics
-        track appreciation.
+      custodian_types: "['*']"
-      specificity_score: '0.60'
-      specificity_rationale: Moderately specific - primarily for digital content engagement
-        contexts.

schemas/20251121/linkml/modules/classes/ApprovalTimeType.yaml

@@ -1,9 +1,13 @@
 id: https://nde.nl/ontology/hc/class/ApprovalTimeType
 name: ApprovalTimeType
+title: Approval Time Type Class
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
   skos: http://www.w3.org/2004/02/skos/core#
+  crm: http://www.cidoc-crm.org/cidoc-crm/
+  schema: http://schema.org/
+default_prefix: hc
 imports:
   - linkml:types
   - ../slots/has_description
@@ -13,11 +17,83 @@ classes:
   ApprovalTimeType:
     class_uri: skos:Concept
     abstract: true
+    description: >-
+      Abstract base class for categorizing expected processing durations for
+      approval workflows, such as immediate, fast, standard, extended, or
+      long approval timeframes.
+    alt_descriptions:
+      nl: >-
+        Abstracte basisklasse voor het categoriseren van verwachte verwerkingstijden
+        voor goedkeuringsworkflows, zoals onmiddellijk, snel, standaard, uitgebreid
+        of lange goedkeuringstermijnen.
+      de: >-
+        Abstrakte Basisklasse zur Kategorisierung erwarteter Verarbeitungszeiten
+        fur Genehmigungsworkflows, wie sofortige, schnelle, standardmassige,
+        erweiterte oder lange Genehmigungszeiträume.
+      fr: >-
+        Classe de base abstraite pour categoriser les delais de traitement attendus
+        pour les flux d'approbation, tels que immediat, rapide, standard, etendu
+        ou longs delais d'approbation.
+      es: >-
+        Clase base abstracta para categorizar las duraciones de procesamiento
+        esperadas para flujos de trabajo de aprobacion, como inmediato, rapido,
+        estandar, extendido o largos plazos de aprobacion.
+      ar: >-
+        فئة أساسية مجردة لتصنيف مدد المعالجة المتوقعة لعمليات الموافقة،
+        مثل الفورية أو السريعة أو القياسية أو الممتدة أو الطويلة.
+      id: >-
+        Kelas dasar abstrak untuk mengkategorikan durasi pemrosesan yang diharapkan
+        untuk alur kerja persetujuan, seperti segera, cepat, standar, diperpanjang,
+        atau waktu persetujuan yang lama.
+      zh: >-
+        用于分类审批流程预期处理持续时间的抽象基类，如即时、快速、标准、
+        延长或长时间审批。
+    structured_aliases:
+    - literal_form: goedkeuringstijdtype
+      in_language: nl
+    - literal_form: Genehmigungszeittyp
+      in_language: de
+    - literal_form: type de delai d'approbation
+      in_language: fr
+    - literal_form: tipo de tiempo de aprobacion
+      in_language: es
+    - literal_form: نوع وقت الموافقة
+      in_language: ar
+    - literal_form: tipe waktu persetujuan
+      in_language: id
+    - literal_form: 审批时间类型
+      in_language: zh
+    broad_mappings:
+    - crm:E52_Time-Span
+    - schema:Duration
+    - skos:Concept
     slots:
     - identified_by
     - has_label
     - has_description
+    slot_usage:
+      has_label:
+        required: true
+      identified_by:
+        required: true
+    comments:
+    - Abstract base class - use specific subclasses (ImmediateApproval, FastApproval, etc.)
+    - Used to set expectations for application processing times
+    - Supports service level agreements and user communication
+    see_also:
+    - ApprovalTimeTypes
+    examples:
+    - value:
+        has_label: "Standard Approval"
+        has_description: "1-2 weeks processing time"
+      description: Standard approval timeframe
+    keywords:
+    - approval time
+    - processing duration
+    - turnaround
+    - service level
+    - workflow
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.3"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Abstract type classification for approval durations
       custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/ApprovalTimeTypes.yaml

@@ -1,5 +1,6 @@
 id: https://nde.nl/ontology/hc/class/ApprovalTimeTypes
 name: ApprovalTimeTypes
+title: Approval Time Types Collection
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
@@ -11,49 +12,259 @@ prefixes:
   rdfs: http://www.w3.org/2000/01/rdf-schema#
   org: http://www.w3.org/ns/org#
   xsd: http://www.w3.org/2001/XMLSchema#
+default_prefix: hc
 imports:
   - ./ApprovalTimeType
   - linkml:types
 classes:
   ImmediateApproval:
     is_a: ApprovalTimeType
-    description: Immediate approval (same day)
+    description: >-
-    annotations:
+      Approval processed on the same day, typically within hours.
-      specificity_score: 0.1
+    alt_descriptions:
-      specificity_rationale: Generic utility class/slot created during migration
+      nl: >-
-      custodian_types: '[''*'']'
+        Goedkeuring verwerkt op dezelfde dag, meestal binnen enkele uren.
+      de: >-
+        Genehmigung am selben Tag bearbeitet, normalerweise innerhalb von Stunden.
+      fr: >-
+        Approbation traitee le meme jour, generalement en quelques heures.
+      es: >-
+        Aprobacion procesada el mismo dia, generalmente en horas.
+      ar: >-
+        الموافقة المعالجة في نفس اليوم، عادة خلال ساعات.
+      id: >-
+        Persetujuan diproses pada hari yang sama, biasanya dalam beberapa jam.
+      zh: >-
+        当天处理的批准，通常在几小时内。
+    structured_aliases:
+    - literal_form: onmiddellijke goedkeuring
+      in_language: nl
+    - literal_form: sofortige Genehmigung
+      in_language: de
+    - literal_form: approbation immediate
+      in_language: fr
+    - literal_form: aprobacion inmediata
+      in_language: es
+    - literal_form: موافقة فورية
+      in_language: ar
+    - literal_form: persetujuan segera
+      in_language: id
+    - literal_form: 即时批准
+      in_language: zh
     broad_mappings:
     - crm:E52_Time-Span
     - schema:Duration
+    examples:
+    - value:
+        has_label: "Immediate"
+        has_description: "Same-day approval"
+      description: Immediate approval timeframe
+    keywords:
+    - immediate
+    - same-day
+    - urgent
+    annotations:
+      specificity_score: "0.4"
+      specificity_rationale: Specific approval duration category
+      custodian_types: "['*']"
   FastApproval:
     is_a: ApprovalTimeType
-    description: Fast approval (1-3 days)
+    description: >-
-    annotations:
+      Approval processed within 1-3 business days.
-      custodian_types: '[''*'']'
+    alt_descriptions:
+      nl: >-
+        Goedkeuring verwerkt binnen 1-3 werkdagen.
+      de: >-
+        Genehmigung innerhalb von 1-3 Werktagen bearbeitet.
+      fr: >-
+        Approbation traitee dans un delai de 1 a 3 jours ouvrables.
+      es: >-
+        Aprobacion procesada dentro de 1-3 dias habiles.
+      ar: >-
+        الموافقة المعالجة خلال 1-3 أيام عمل.
+      id: >-
+        Persetujuan diproses dalam 1-3 hari kerja.
+      zh: >-
+        1-3个工作日内处理的批准。
+    structured_aliases:
+    - literal_form: snelle goedkeuring
+      in_language: nl
+    - literal_form: schnelle Genehmigung
+      in_language: de
+    - literal_form: approbation rapide
+      in_language: fr
+    - literal_form: aprobacion rapida
+      in_language: es
+    - literal_form: موافقة سريعة
+      in_language: ar
+    - literal_form: persetujuan cepat
+      in_language: id
+    - literal_form: 快速批准
+      in_language: zh
     broad_mappings:
     - crm:E52_Time-Span
     - schema:Duration
+    examples:
+    - value:
+        has_label: "Fast"
+        has_description: "1-3 business days"
+      description: Fast approval timeframe
+    keywords:
+    - fast
+    - 1-3 days
+    - expedited
+    annotations:
+      specificity_score: "0.4"
+      specificity_rationale: Specific approval duration category
+      custodian_types: "['*']"
   StandardApproval:
     is_a: ApprovalTimeType
-    description: Standard approval (1-2 weeks)
+    description: >-
-    annotations:
+      Approval processed within 1-2 weeks.
-      custodian_types: '[''*'']'
+    alt_descriptions:
+      nl: >-
+        Goedkeuring verwerkt binnen 1-2 weken.
+      de: >-
+        Genehmigung innerhalb von 1-2 Wochen bearbeitet.
+      fr: >-
+        Approbation traitee dans un delai de 1 a 2 semaines.
+      es: >-
+        Aprobacion procesada dentro de 1-2 semanas.
+      ar: >-
+        الموافقة المعالجة خلال 1-2 أسبوع.
+      id: >-
+        Persetujuan diproses dalam 1-2 minggu.
+      zh: >-
+        1-2周内处理的批准。
+    structured_aliases:
+    - literal_form: standaardgoedkeuring
+      in_language: nl
+    - literal_form: Standardgenehmigung
+      in_language: de
+    - literal_form: approbation standard
+      in_language: fr
+    - literal_form: aprobacion estandar
+      in_language: es
+    - literal_form: موافقة قياسية
+      in_language: ar
+    - literal_form: persetujuan standar
+      in_language: id
+    - literal_form: 标准批准
+      in_language: zh
     broad_mappings:
     - crm:E52_Time-Span
     - schema:Duration
+    examples:
+    - value:
+        has_label: "Standard"
+        has_description: "1-2 weeks"
+      description: Standard approval timeframe
+    keywords:
+    - standard
+    - 1-2 weeks
+    - normal
+    annotations:
+      specificity_score: "0.4"
+      specificity_rationale: Specific approval duration category
+      custodian_types: "['*']"
   ExtendedApproval:
     is_a: ApprovalTimeType
-    description: Extended approval (2-4 weeks)
+    description: >-
-    annotations:
+      Approval processed within 2-4 weeks.
-      custodian_types: '[''*'']'
+    alt_descriptions:
+      nl: >-
+        Goedkeuring verwerkt binnen 2-4 weken.
+      de: >-
+        Genehmigung innerhalb von 2-4 Wochen bearbeitet.
+      fr: >-
+        Approbation traitee dans un delai de 2 a 4 semaines.
+      es: >-
+        Aprobacion procesada dentro de 2-4 semanas.
+      ar: >-
+        الموافقة المعالجة خلال 2-4 أسبوع.
+      id: >-
+        Persetujuan diproses dalam 2-4 minggu.
+      zh: >-
+        2-4周内处理的批准。
+    structured_aliases:
+    - literal_form: uitgebreide goedkeuring
+      in_language: nl
+    - literal_form: erweiterte Genehmigung
+      in_language: de
+    - literal_form: approbation etendue
+      in_language: fr
+    - literal_form: aprobacion extendida
+      in_language: es
+    - literal_form: موافقة ممتدة
+      in_language: ar
+    - literal_form: persetujuan diperpanjang
+      in_language: id
+    - literal_form: 延长批准
+      in_language: zh
     broad_mappings:
     - crm:E52_Time-Span
     - schema:Duration
+    examples:
+    - value:
+        has_label: "Extended"
+        has_description: "2-4 weeks"
+      description: Extended approval timeframe
+    keywords:
+    - extended
+    - 2-4 weeks
+    - complex
+    annotations:
+      specificity_score: "0.4"
+      specificity_rationale: Specific approval duration category
+      custodian_types: "['*']"
   LongApproval:
     is_a: ApprovalTimeType
-    description: Long approval (1+ months)
+    description: >-
-    annotations:
+      Approval taking one month or longer, typically for complex requests.
-      custodian_types: '[''*'']'
+    alt_descriptions:
+      nl: >-
+        Goedkeuring die een maand of langer duurt, meestal voor complexe verzoeken.
+      de: >-
+        Genehmigung, die einen Monat oder langer dauert, normalerweise fur komplexe Anfragen.
+      fr: >-
+        Approbation prenant un mois ou plus, generalement pour les demandes complexes.
+      es: >-
+        Aprobacion que toma un mes o mas, generalmente para solicitudes complejas.
+      ar: >-
+        الموافقة التي تستغرق شهرًا أو أكثر، عادة للطلبات المعقدة.
+      id: >-
+        Persetujuan yang memakan waktu satu bulan atau lebih, biasanya untuk permintaan kompleks.
+      zh: >-
+        需要一个月或更长时间的批准，通常用于复杂请求。
+    structured_aliases:
+    - literal_form: lange goedkeuring
+      in_language: nl
+    - literal_form: lange Genehmigung
+      in_language: de
+    - literal_form: approbation longue
+      in_language: fr
+    - literal_form: aprobacion larga
+      in_language: es
+    - literal_form: موافقة طويلة
+      in_language: ar
+    - literal_form: persetujuan lama
+      in_language: id
+    - literal_form: 长期批准
+      in_language: zh
     broad_mappings:
     - crm:E52_Time-Span
     - schema:Duration
+    examples:
+    - value:
+        has_label: "Long"
+        has_description: "1+ months"
+      description: Long approval timeframe
+    keywords:
+    - long
+    - 1+ months
+    - complex
+    - thorough review
+    annotations:
+      specificity_score: "0.4"
+      specificity_rationale: Specific approval duration category
+      custodian_types: "['*']"

schemas/20251121/linkml/modules/classes/Approver.yaml

@@ -1,10 +1,6 @@
 id: https://nde.nl/ontology/hc/class/Approver
 name: approver_class
 title: Approver Class
-imports:
-  - linkml:types
-  - ../slots/identified_by
-  - ../slots/has_label
 prefixes:
   linkml: https://w3id.org/linkml/
   hc: https://nde.nl/ontology/hc/
@@ -18,25 +14,59 @@ prefixes:
   org: http://www.w3.org/ns/org#
   xsd: http://www.w3.org/2001/XMLSchema#
 default_prefix: hc
+imports:
+  - linkml:types
+  - ../slots/identified_by
+  - ../slots/has_label
 classes:
   Approver:
-    class_uri: prov:Agent
+    class_uri: hc:Approver
-    description: 'An agent (person or organization) that approves or authorized something.
+    description: >-
-
+      Agent responsible for authorizing or approving decisions, policies,
-      **DEFINITION**:
+      budgets, or other organizational actions in heritage institution workflows.
-
+    alt_descriptions:
-      Approver represents the agent responsible for approving decisions, policies, budgets, or other organizational actions. This replaces simple string fields like `approved_by` with a structured class that can link to person or organization entities.
+      nl: >-
-
+        Agent die verantwoordelijk is voor het autoriseren of goedkeuren van
-      **ONTOLOGY ALIGNMENT**:
+        beslissingen, beleid, budgetten of andere organisatorische acties in
-
+        erfgoedinstellingsworkflows.
-      - PROV-O: `prov:Agent` - entity that bears responsibility - FOAF: `foaf:Agent` - agent (person or organization) - Schema.org: `schema:Person` or `schema:Organization`
+      de: >-
-
+        Agent, der fur die Autorisierung oder Genehmigung von Entscheidungen,
-      **USE CASES**:
+        Richtlinien, Budgets oder anderen organisatorischen Massnahmen in
-
+        Kulturerbe-Institutionsworkflows verantwortlich ist.
-      1. **Budget Approval**: Who approved the budget allocation 2. **Policy Approval**: Who authorized the policy 3. **Decision Records**: Documenting approval chains'
+      fr: >-
-    exact_mappings:
+        Agent responsable de l'autorisation ou de l'approbation des decisions,
+        politiques, budgets ou autres actions organisationnelles dans les flux
+        de travail des institutions patrimoniales.
+      es: >-
+        Agente responsable de autorizar o aprobar decisiones, politicas,
+        presupuestos u otras acciones organizativas en los flujos de trabajo
+        de las instituciones patrimoniales.
+      ar: >-
+        الوكيل المسؤول عن ترخيص أو الموافقة على القرارات أو السياسات أو
+        الميزانيات أو الإجراءات التنظيمية الأخرى في سير عمل مؤسسات التراث.
+      id: >-
+        Agen yang bertanggung jawab untuk mengesahkan atau menyetujui keputusan,
+        kebijakan, anggaran, atau tindakan organisasi lainnya dalam alur kerja
+        lembaga warisan budaya.
+      zh: >-
+        在遗产机构工作流程中负责授权或批准决策、政策、预算或其他组织行动的代理。
+    structured_aliases:
+    - literal_form: goedkeurder
+      in_language: nl
+    - literal_form: Genehmigender
+      in_language: de
+    - literal_form: approbateur
+      in_language: fr
+    - literal_form: aprobador
+      in_language: es
+    - literal_form: موافق
+      in_language: ar
+    - literal_form: penyetuju
+      in_language: id
+    - literal_form: 审批者
+      in_language: zh
+    broad_mappings:
     - prov:Agent
-    close_mappings:
     - foaf:Agent
     - schema:Person
     - schema:Organization
@@ -45,25 +75,40 @@ classes:
     - identified_by
     slot_usage:
       has_label:
-#         range: string
         examples:
         - value: Board of Directors
         - value: Museum Director
+        - value: Department Head
+        - value: Collections Committee
       identified_by:
-#         range: string # uriorcurie
         examples:
         - value: https://nde.nl/ontology/hc/person/jan-de-vries
+        - value: https://ror.org/054hq1305
     comments:
-    - Generic approver class for approval provenance
+    - Generic approver class for approval provenance tracking
     - Can represent individuals or organizational bodies
-    - Aligns with PROV-O Agent for provenance tracking
+    - Aligns with PROV-O Agent for provenance
+    - Used to document approval chains and decision authority
     see_also:
     - https://www.w3.org/TR/prov-o/#Agent
+    - Applicant
     examples:
     - value:
         has_label: Museum Director
         identified_by: https://nde.nl/ontology/hc/person/example-director
+      description: Individual approver (museum director)
+    - value:
+        has_label: Board of Directors
+        identified_by: https://ror.org/054hq1305
+      description: Organizational approver (board)
+    keywords:
+    - approver
+    - authorizer
+    - decision maker
+    - approval chain
+    - provenance
+    - authorization
     annotations:
-      specificity_score: 0.1
+      specificity_score: "0.4"
-      specificity_rationale: Generic utility class/slot created during migration
+      specificity_rationale: Role class for approval authorization
       custodian_types: "['*']"