53c6dbc2d9
Major slot migrations following slot_fixes.yaml revisions: - TimeSpan: begin_of_the_begin, begin_of_the_end, end_of_the_begin, end_of_the_end - Quantity: has_or_had_measurement_unit with MeasureUnit class - Description: has_or_had_description with Description class - URL, WikiData, Timestamp, Location, Provenance pattern classes New slots for RiC-O compliance: - Temporal: has_or_had_time_interval, calendar_system - Transfer: is_or_was_transferred, has_or_had_policy - Location: starts/ends_or_started/ended_at_location - Provenance: has_or_had_provenance_path, is_or_was_webarchived_at Archive deprecated slots per Rule 53 workflow.
148 lines
5 KiB
YAML
148 lines
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
|
|
# - type_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
|
|
- ../slots/description_text
|
|
- ../slots/description_type
|
|
- ../slots/language
|
|
- ../slots/specificity_annotation
|
|
- ../slots/template_specificity
|
|
- ./SpecificityAnnotation
|
|
- ./TemplateSpecificityScores
|
|
|
|
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:
|
|
- description_text
|
|
- description_type
|
|
- language
|
|
- specificity_annotation
|
|
- template_specificity
|
|
|
|
slot_usage:
|
|
description_text:
|
|
description: |
|
|
The textual content of the description.
|
|
range: string
|
|
required: true
|
|
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:
|
|
- value: |
|
|
description_text: "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: |
|
|
description_text: "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: |
|
|
description_text: "Regional branch serving Noord-Holland province with specialized genealogy and notarial collections."
|
|
description_type: branch
|
|
language: en
|
|
description: "Branch description for organizational unit"
|