glam/schemas/20251121/linkml/modules/classes/Notes.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

104 lines
No EOL
3 KiB
YAML

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