- Created 'updated_at.yaml' to record the last modified date and time of entities, including multilingual descriptions and structured aliases. - Created 'written_in.yaml' to specify the language in which content is composed, covering both natural and programming languages, with detailed comments and close ontology mappings.
120 lines
No EOL
4.2 KiB
YAML
120 lines
No EOL
4.2 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/20260202_matang/new/description_type
|
|
- ../slots/20260202_matang/has_content
|
|
- ../slots/20260202_matang/has_score # was: template_specificity
|
|
- ../slots/20260202_matang/new/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
|
|
- description_type
|
|
- 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."
|
|
description_type:
|
|
# range: string
|
|
required: false
|
|
examples:
|
|
- value: binding
|
|
- value: branch
|
|
- value: budget
|
|
- value: zone
|
|
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 |