id: https://nde.nl/ontology/hc/class/Notes
name: notes_class
title: Notes 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_or_had_score  # was: template_specificity
- ../slots/language
- ../slots/note_content
- ../slots/note_date
- ../slots/note_type
- ../slots/specificity_annotation
- ./SpecificityAnnotation
- ./TemplateSpecificityScore  # was: TemplateSpecificityScores
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
classes:
  Notes:
    class_uri: skos:note
    description: |
      A typed note with optional provenance metadata.
      
      **Purpose**:
      Notes provides a reusable class for representing documentation notes
      across the heritage custodian schema. Supports typed notes (appraisal,
      arrangement, conservation, etc.) with language tagging and dates.
      
      **Ontological Alignment**:
      - **Primary**: `skos:note` - general note
      - **Close**: `rdfs:comment` - comment on resource
      
      **Use Cases**:
      - Appraisal notes documenting retention decisions
      - Arrangement notes documenting physical organization
      - Conservation notes documenting treatments
      - Processing notes documenting archival workflow
      - General documentation notes
      
      **Replaces**:
      - `appraisal_notes` (string) - now typed with note_type
      
    exact_mappings:
      - skos:note
    
    close_mappings:
      - rdfs:comment
      - dcterms:description
    
    slots:
      - note_type
      - note_content
      - note_date
      - language
      - specificity_annotation
      - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    
    slot_usage:
      note_type:
        range: string
        required: false
        examples:
          - value: appraisal
          - value: arrangement
          - value: conservation
      note_content:
        range: string
        required: true
      note_date:
        range: date
        required: false
      language:
        range: string
        required: false
        pattern: "^[a-z]{2}$"
    
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: Generic notes class applicable to all types.
      custodian_types_primary: null
      specificity_score: 0.3
      specificity_rationale: Broadly applicable generic class for documentation notes.
    
    examples:
      - value: |
          note_type: appraisal
          note_content: "Retained all policy files; destroyed duplicate copies and routine correspondence per retention schedule RS-2020-05"
          note_date: "2024-03-15"
          language: en
      - value: |
          note_type: arrangement
          note_content: "Maintained original order by correspondent. Created 5 series by function. Rehoused into acid-free folders and boxes."
          note_date: "2024-06-01"
          language: en