kempersc 554fe520ea Add comprehensive rules for LinkML schema management and ontology mapping

- Introduced Rule 42: No Ontology Prefixes in Slot Names to enforce clean naming conventions.
- Established Rule: No Rough Edits in Schema Files to ensure structural integrity during modifications.
- Implemented Rule: No Version Indicators in Names to maintain stable semantic naming.
- Created Rule: Ontology Detection vs Heuristics to emphasize the importance of verifying ontology definitions.
- Defined Rule 50: Ontology-to-LinkML Mapping Convention to standardize mapping practices.
- Added Rule: Polished Slot Storage Location to specify directory structure for polished slot files.
- Enforced Rule: Preserve Bespoke Slots Until Refactoring to prevent unintended migrations during slot updates.
- Instituted Rule 56: Semantic Consistency Over Simplicity to mandate execution of revisions in slot_fixes.yaml.
- Added new Genealogy Archives Registry Enrichment class with multilingual support and structured aliases.

2026-02-15 19:20:09 +01:00

5.4 KiB

Raw Blame History

Rule: Multilingual Support Requirements

Overview

All LinkML slot files MUST include multilingual support with translations in the following languages:

Code	Language	Required
`nl`	Dutch	✅ Yes
`de`	German	✅ Yes
`fr`	French	✅ Yes
`ar`	Arabic	✅ Yes
`id`	Indonesian	✅ Yes
`zh`	Chinese (Simplified)	✅ Yes
`es`	Spanish	✅ Yes

Required Multilingual Fields

1. `alt_descriptions`

Provide faithful translations of the English description field:

slots:
  my_slot:
    description: >-
      To possess a specific structural arrangement or encoding standard.      
    alt_descriptions:
      nl: >-
        Het bezitten van een specifieke structurele rangschikking of coderingsstandaard.        
      de: >-
        Das Besitzen einer spezifischen strukturellen Anordnung oder eines Kodierungsstandards.        
      fr: >-
        Posséder un arrangement structurel spécifique ou une norme de codage.        
      ar: >-
        امتلاك ترتيب هيكلي محدد أو معيار ترميز.        
      id: >-
        Memiliki susunan struktural tertentu atau standar pengkodean.        
      zh: >-
        拥有特定的结构安排或编码标准。        
      es: >-
        Poseer una disposición estructural específica o un estándar de codificación.

2. `structured_aliases`

Provide translated slot names/labels for each language:

slots:
  has_format:
    structured_aliases:
      - literal_form: heeft formaat
        predicate: EXACT_SYNONYM
        in_language: nl
      - literal_form: hat Format
        predicate: EXACT_SYNONYM
        in_language: de
      - literal_form: a un format
        predicate: EXACT_SYNONYM
        in_language: fr
      - literal_form: لديه تنسيق
        predicate: EXACT_SYNONYM
        in_language: ar
      - literal_form: memiliki format
        predicate: EXACT_SYNONYM
        in_language: id
      - literal_form: 具有格式
        predicate: EXACT_SYNONYM
        in_language: zh
      - literal_form: tiene formato
        predicate: EXACT_SYNONYM
        in_language: es

Translation Guidelines

DO:

Translate the semantic meaning faithfully
Preserve technical precision
Use natural phrasing for each language
Keep translations concise (similar length to English)

DON'T:

Paraphrase or expand beyond the original meaning
Add information not present in the English description
Use machine translation without review
Skip any of the required languages

Complete Example

id: https://nde.nl/ontology/hc/slot/catalogue
name: catalogue
title: catalogue

slots:
  catalogue:
    slot_uri: crm:P70_documents
    description: >-
      To systematically record, classify, and organize items within a structured 
      inventory or database for the purposes of documentation and retrieval.      
    alt_descriptions:
      nl: >-
        Het systematisch vastleggen, classificeren en ordenen van items binnen een 
        gestructureerde inventaris of database voor documentatie en terugvinding.        
      de: >-
        Das systematische Erfassen, Klassifizieren und Ordnen von Objekten in einem 
        strukturierten Inventar oder einer Datenbank für Dokumentation und Abruf.        
      fr: >-
        Enregistrer, classer et organiser systématiquement des éléments dans un 
        inventaire structuré ou une base de données à des fins de documentation et de récupération.        
      ar: >-
        تسجيل وتصنيف وتنظيم العناصر بشكل منهجي ضمن جرد منظم أو قاعدة بيانات لأغراض التوثيق والاسترجاع.        
      id: >-
        Mencatat, mengklasifikasikan, dan mengatur item secara sistematis dalam 
        inventaris terstruktur atau database untuk tujuan dokumentasi dan pengambilan.        
      zh: >-
        在结构化清单或数据库中系统地记录、分类和组织项目，以便于文档编制和检索。        
      es: >-
        Registrar, clasificar y organizar sistemáticamente elementos dentro de un 
        inventario estructurado o base de datos con fines de documentación y recuperación.        
    structured_aliases:
      - literal_form: catalogiseren
        predicate: EXACT_SYNONYM
        in_language: nl
      - literal_form: katalogisieren
        predicate: EXACT_SYNONYM
        in_language: de
      - literal_form: cataloguer
        predicate: EXACT_SYNONYM
        in_language: fr
      - literal_form: فهرسة
        predicate: EXACT_SYNONYM
        in_language: ar
      - literal_form: mengkatalogkan
        predicate: EXACT_SYNONYM
        in_language: id
      - literal_form: 编目
        predicate: EXACT_SYNONYM
        in_language: zh
      - literal_form: catalogar
        predicate: EXACT_SYNONYM
        in_language: es

Validation Checklist

Before completing a slot file, verify:

alt_descriptions provided for all 7 languages (nl, de, fr, ar, id, zh, es)
structured_aliases provided for all 7 languages
Translations are faithful to the English original
No language is skipped or left empty
Arabic and Chinese characters render correctly

5.4 KiB Raw Blame History