7cf10084b4
- Added `fix_dual_class_link.py` to remove dual class link references from specified YAML files. - Created `fix_specific_ghosts.py` to apply specific replacements in YAML files based on defined mappings. - Introduced `migrate_staff_count.py` to migrate staff count references to a new structure in specified YAML files. - Developed `migrate_type_slots.py` to replace type-related slots with new identifiers across YAML files. - Implemented `scan_ghost_references.py` to identify and report ghost references to archived slots and classes in YAML files. - Added `verify_ontology_terms.py` to verify the presence of ontology terms in specified ontology files against schema definitions.
175 lines
6.5 KiB
YAML
175 lines
6.5 KiB
YAML
# Description class
|
|
# Generic class for typed descriptions with language support
|
|
#
|
|
# Generation date: 2026-01-15
|
|
# Rule compliance: 0 (LinkML single source of truth), 38 (slot centralization), 53 (slot_fixes.yaml authoritative)
|
|
# Migration: Supports has_or_had_description slot (replaces binding_description, branch_description, etc.)
|
|
#
|
|
# This class supports 11 slot migrations per slot_fixes.yaml:
|
|
# - binding_description
|
|
# - branch_description
|
|
# - branch_office_description
|
|
# - budget_description
|
|
# - zone_description
|
|
# - warehouse_description
|
|
# - unit_description
|
|
# - has_or_had_description
|
|
# - treatment_description (partial)
|
|
# - transfer_location_text (partial)
|
|
# - transfer_location (partial)
|
|
|
|
id: https://nde.nl/ontology/hc/class/Description
|
|
name: description_class
|
|
title: Description Class
|
|
|
|
prefixes:
|
|
linkml: https://w3id.org/linkml/
|
|
hc: https://nde.nl/ontology/hc/
|
|
skos: http://www.w3.org/2004/02/skos/core#
|
|
rdfs: http://www.w3.org/2000/01/rdf-schema#
|
|
schema: http://schema.org/
|
|
dcterms: http://purl.org/dc/terms/
|
|
|
|
default_prefix: hc
|
|
|
|
imports:
|
|
- linkml:types
|
|
- ../metadata
|
|
# MIGRATED 2026-01-25: description_text → has_or_had_content + Content (Rule 53)
|
|
- ../slots/has_or_had_content
|
|
- ./Content
|
|
- ../slots/description_type
|
|
- ../slots/language
|
|
- ../slots/specificity_annotation
|
|
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
- ./SpecificityAnnotation
|
|
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
|
|
|
|
- ./TemplateSpecificityType
|
|
|
|
- ./TemplateSpecificityTypes
|
|
|
|
classes:
|
|
Description:
|
|
class_uri: dcterms:description
|
|
description: |
|
|
A typed description with optional language tagging and type metadata.
|
|
|
|
**Purpose**:
|
|
Description provides a reusable class for representing textual descriptions
|
|
across the heritage custodian schema. Supports typed descriptions (binding,
|
|
branch, budget, zone, etc.) with language tagging.
|
|
|
|
**Ontological Alignment**:
|
|
- **Primary**: `dcterms:description` - Dublin Core description
|
|
- **Close**: `skos:definition` - formal definition
|
|
- **Related**: `schema:description` - Schema.org description
|
|
|
|
**Use Cases**:
|
|
- Binding descriptions for physical carriers
|
|
- Branch/office descriptions for organizational units
|
|
- Budget descriptions for financial records
|
|
- Zone/warehouse descriptions for storage facilities
|
|
- Type descriptions for classification explanations
|
|
|
|
**Replaces** (per slot_fixes.yaml):
|
|
- `binding_description` (string)
|
|
- `branch_description` (string)
|
|
- `branch_office_description` (string)
|
|
- `budget_description` (string)
|
|
- `zone_description` (string)
|
|
- `warehouse_description` (string)
|
|
- `unit_description` (string)
|
|
- `type_description` (string)
|
|
|
|
exact_mappings:
|
|
- dcterms:description
|
|
|
|
close_mappings:
|
|
- skos:definition
|
|
- rdfs:comment
|
|
|
|
related_mappings:
|
|
- schema:description
|
|
|
|
slots:
|
|
# MIGRATED 2026-01-25: description_text → has_or_had_content (Rule 53)
|
|
- has_or_had_content
|
|
- description_type
|
|
- language
|
|
- specificity_annotation
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
|
|
slot_usage:
|
|
# DEPRECATED 2026-01-25: description_text migrated to has_or_had_content + Content (Rule 53)
|
|
# Old slot archived: modules/slots/archive/description_text_archived_20260125.yaml
|
|
has_or_had_content:
|
|
description: |
|
|
The content of the description, modeled as Content class.
|
|
MIGRATED from description_text (string) per Rule 53.
|
|
|
|
**Migration Pattern**:
|
|
- Old: description_text: "Climate-controlled storage zone..."
|
|
- New: has_or_had_content with has_or_had_label and has_or_had_description
|
|
range: Content
|
|
required: true
|
|
inlined: true
|
|
examples:
|
|
- value:
|
|
has_or_had_label: "Zone Description"
|
|
has_or_had_description: "Climate-controlled storage zone with dedicated HVAC for archival materials."
|
|
description: Content for zone description
|
|
description_type:
|
|
description: |
|
|
The type of description (binding, branch, budget, zone, warehouse, unit, type, general).
|
|
This allows distinguishing different kinds of descriptions when multiple
|
|
apply to the same entity.
|
|
range: string
|
|
required: false
|
|
examples:
|
|
- value: binding
|
|
description: Physical binding description
|
|
- value: branch
|
|
description: Organizational branch description
|
|
- value: budget
|
|
description: Budget category description
|
|
- value: zone
|
|
description: Storage zone description
|
|
language:
|
|
description: |
|
|
ISO 639-1 two-letter language code for this description.
|
|
Examples: "en", "nl", "de", "fr"
|
|
range: string
|
|
required: false
|
|
pattern: "^[a-z]{2}$"
|
|
|
|
annotations:
|
|
custodian_types: '["*"]'
|
|
custodian_types_rationale: Generic description class applicable to all custodian types.
|
|
custodian_types_primary: null
|
|
specificity_score: 0.2
|
|
specificity_rationale: Very broadly applicable generic class for textual descriptions.
|
|
|
|
examples:
|
|
# MIGRATED 2026-01-25: examples updated to use has_or_had_content + Content (Rule 53)
|
|
- value:
|
|
has_or_had_content:
|
|
has_or_had_label: "Storage Zone Climate Control"
|
|
has_or_had_description: "Climate-controlled storage zone with dedicated HVAC for archival materials. Maintains 65°F and 35% RH."
|
|
description_type: zone
|
|
language: en
|
|
description: "Zone description for archival storage facility"
|
|
- value:
|
|
has_or_had_content:
|
|
has_or_had_label: "Quarter Leather Binding"
|
|
has_or_had_description: "Quarter leather binding with marbled boards, spine with five raised bands and gilt titling."
|
|
description_type: binding
|
|
language: en
|
|
description: "Binding description for a rare book"
|
|
- value:
|
|
has_or_had_content:
|
|
has_or_had_label: "Noord-Holland Regional Branch"
|
|
has_or_had_description: "Regional branch serving Noord-Holland province with specialized genealogy and notarial collections."
|
|
description_type: branch
|
|
language: en
|
|
description: "Branch description for organizational unit"
|