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

113 lines
No EOL
3.5 KiB
YAML

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: |
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
close_mappings:
- skos:note
- rdfs:comment
- dcterms:description
slots:
- has_type
- has_content
- has_timestamp
- in_language
- has_score
slot_usage:
has_type:
# range: string
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}$"
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