glam/schemas/20251121/linkml/modules/classes/Note.yaml
kempersc ca4a54181e Refactor schema files to improve clarity and maintainability
- Updated WorldCatIdentifier.yaml to remove unnecessary description and ensure consistent formatting.
- Enhanced WorldHeritageSite.yaml by breaking long description into multiple lines for better readability and removed unused attributes.
- Simplified WritingSystem.yaml by removing redundant attributes and ensuring consistent formatting.
- Cleaned up XPathScore.yaml by removing unnecessary attributes and ensuring consistent formatting.
- Improved YoutubeChannel.yaml by breaking long description into multiple lines for better readability.
- Enhanced YoutubeEnrichment.yaml by breaking long description into multiple lines for better readability.
- Updated YoutubeVideo.yaml to break long description into multiple lines and removed legacy field name.
- Refined has_or_had_affiliation.yaml by removing unnecessary comments and ensuring clarity.
- Cleaned up is_or_was_retrieved_at.yaml by removing unnecessary comments and ensuring clarity.
- Added rules for generic slots and avoiding rough edits in schema files to maintain structural integrity.
- Introduced changes_or_changed_through.yaml to define a new slot for linking entities to change events.
2026-01-31 00:46:23 +01:00

121 lines
No EOL
3.7 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_or_had_score
- ../slots/language
- ../slots/note_content
- ../slots/note_date
- ../slots/note_type
- ../slots/specificity_annotation
- ./SpecificityAnnotation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
classes:
Note:
class_uri: skos: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_or_had_note with Note class
- `category_note` (string) → has_or_had_note with Note class
- `certainty_note` (string) → has_or_had_note with Note class
- `conservation_note` (string) → has_or_had_note with Note class
- `copy_note` (string) → has_or_had_note with Note class
- `event_note` (string) → has_or_had_note with Note class
- `extraction_note` (string) → has_or_had_note with Note class
- `feature_note` (string) → has_or_had_note with Note class
- Other *_note slots per slot_fixes.yaml
exact_mappings:
- skos:note
close_mappings:
- rdfs:comment
- dcterms:description
slots:
- note_type
- note_content
- note_date
- language
- specificity_annotation
- has_or_had_score
slot_usage:
note_type:
range: string
required: false
examples:
- value: claim
- value: category
- value: conservation
- value: extraction
- value: general
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 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