glam/schemas/20251121/linkml/modules/classes/Description.yaml

120 lines
No EOL
4.1 KiB
YAML

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/has_type
- ../slots/has_content
- ../slots/has_score # was: template_specificity
- ../slots/in_language
classes:
Description:
class_uri: hc: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)
close_mappings:
- dcterms:description
- skos:definition
- rdfs:comment
related_mappings:
- schema:description
slots:
# MIGRATED 2026-01-25: description_text → has_content (Rule 53)
- has_content
- has_type
- in_language
- has_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
slot_usage:
# DEPRECATED 2026-01-25: description_text migrated to has_content + Content (Rule 53)
# Old slot archived: modules/slots/archive/description_text_archived_20260125.yaml
has_content:
# range: string
required: true
inlined: false # Fixed invalid inline for primitive type
examples:
- value:
has_label: "Zone Description"
has_description: "Climate-controlled storage zone with dedicated HVAC for archival materials."
has_type:
# range: string
required: false
examples:
- value: binding
- value: branch
- value: budget
- value: zone
in_language:
# 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_content + Content (Rule 53)
- value:
has_content:
has_label: "Storage Zone Climate Control"
has_description: "Climate-controlled storage zone with dedicated HVAC for archival materials. Maintains 65°F and 35% RH."
description_type: zone
language: en
- value:
has_content:
has_label: "Quarter Leather Binding"
has_description: "Quarter leather binding with marbled boards, spine with five raised bands and gilt titling."
description_type: binding
language: en
- value:
has_content:
has_label: "Noord-Holland Regional Branch"
has_description: "Regional branch serving Noord-Holland province with specialized genealogy and notarial collections."
description_type: branch
language: en