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_type
- ../slots/has_or_had_content
- ../slots/has_or_had_score  # was: template_specificity
- ../slots/language
- ../slots/specificity_annotation
- ./Content
- ./SpecificityAnnotation
- ./TemplateSpecificityScore  # was: TemplateSpecificityScores
- ./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)
      
    close_mappings:
      - dcterms:description
      - 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:
        range: string
        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_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_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
      - 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
      - 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