4319f38c05
- Created new YAML files for audience size and audience type slots, defining their properties and annotations. - Added archived capacity slots including cubic meters, linear meters, item count, and descriptions, with appropriate URIs and ranges. - Introduced a template specificity slot for context-aware RAG filtering. - Consolidated capacity-related slots into a unified structure, including has_or_had_capacity, capacity_type, and capacity_value, with detailed descriptions and examples.
152 lines
5.2 KiB
YAML
152 lines
5.2 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/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:
|
|
- description_text
|
|
- description_type
|
|
- language
|
|
- specificity_annotation
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
|
|
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"
|