id: https://nde.nl/ontology/hc/class/Note
name: note_class
title: Note 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_score
  - ../slots/in_language
  - ../slots/has_content
  - ../slots/has_timestamp
  - ../slots/has_type
classes:
  Note:
    class_uri: hc:Note
    description: Typed note content with optional language, timestamp, and confidence metadata.
      
    close_mappings:
      - skos:note
      - rdfs:comment
      - dcterms:description
    
    slots:
      - has_type
      - has_content
      - has_timestamp
      - in_language
      - has_score
    
    slot_usage:
      has_type:
        required: false
        examples:
          - value: claim
          - value: category
          - value: conservation
          - value: extraction
          - value: general
      has_content:
#         range: string
        required: true
      has_timestamp:
        range: date
        required: false
      in_language:
#         range: string
        required: false
        pattern: "^[a-z]{2}$"
    
    notes:
      - |
        Preserved from prior description (commit 6e634651):

        Preserved from prior description (commit 6e634651):

        A typed note with optional provenance metadata.

        **Purpose**:
        Note provides a reusable class for representing documentation notes
        across the heritage custodian schema. Supports typed notes (claim,
        appraisal, arrangement, conservation, extraction, etc.) with language
        tagging and dates.

        **Ontological Alignment**:
        - **Primary**: `skos:note` - general note
        - **Close**: `rdfs:comment` - comment on resource

        **Use Cases**:
        - Claim notes documenting extraction details
        - Category notes for classification explanations
        - Certainty notes for confidence documentation
        - Conservation notes documenting treatments
        - Extraction notes for pipeline documentation
        - General documentation notes

        **Replaces** (per slot_fixes.yaml):
        - `claim_note` (string) → has_note with Note class
        - `category_note` (string) → has_note with Note class
        - `certainty_note` (string) → has_note with Note class
        - `conservation_note` (string) → has_note with Note class
        - `copy_note` (string) → has_note with Note class
        - `event_note` (string) → has_note with Note class
        - `extraction_note` (string) → has_note with Note class
        - `feature_note` (string) → has_note with Note class
        - Other *_note slots per slot_fixes.yaml
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: Generic note class applicable to all custodian types.
      custodian_types_primary: null
      specificity_score: 0.2
      specificity_rationale: Very broadly applicable generic class for documentation notes.
    
    examples:
      - value: |
          note_type: claim
          note_content: "Additional verification required for this claim. Source webpage may have changed since extraction."
          note_date: "2026-01-18"
          language: en
      - value: |
          note_type: extraction
          note_content: "Biography truncated from longer text on page. Original text exceeded 500 chars."
          note_date: "2025-11-29"
          language: en
      - value: |
          note_type: conservation
          note_content: "Surface cleaning completed. No further treatment recommended at this time."
          note_date: "2024-06-15"
          language: en