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

94 lines
2.7 KiB
YAML

id: https://nde.nl/ontology/hc/class/Reference
name: Reference
title: Reference Class
description: >-
Represents a bibliographic or source reference with citation text and metadata.
**USE CASES**:
- Source citations for birth/death dates from historical documents
- Documentary evidence supporting claims
- Catalog or finding aid references
**EXAMPLE**:
```yaml
Reference:
citation_text: "born in the year of our Lord 1823"
source_type: "parish_register"
source_location: "Amsterdam Stadsarchief, DTB 123"
```
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
dcterms: http://purl.org/dc/terms/
schema: http://schema.org/
bibo: http://purl.org/ontology/bibo/
default_prefix: hc
imports:
- linkml:types
- ../slots/has_or_had_label
- ./Label
classes:
Reference:
class_uri: dcterms:BibliographicResource
description: >-
A bibliographic or documentary reference containing citation text
and source metadata.
exact_mappings:
- dcterms:BibliographicResource
close_mappings:
- schema:CreativeWork
- bibo:Document
attributes:
citation_text:
range: string
description: >-
Verbatim text from the source document. Preserves original wording
for archival/historical research.
examples:
- value: "born in the year of our Lord 1823"
- value: "ca. 1750"
- value: "late 18th century"
source_type:
range: string
description: >-
Type of source document (e.g., parish_register, census,
birth_certificate, newspaper, biography).
examples:
- value: "parish_register"
- value: "census_record"
- value: "newspaper_obituary"
source_location:
range: string
description: >-
Location or identifier of the source (e.g., archive call number,
repository identifier, URL).
examples:
- value: "Amsterdam Stadsarchief, DTB 123"
- value: "https://www.familysearch.org/ark:/12345"
source_date:
range: date
description: >-
Date of the source document (when known).
slots:
- has_or_had_label
slot_usage:
has_or_had_label:
range: string
inlined: true
examples:
- value:
label_value: "Parish register entry for Johannes van Berg"
examples:
- value:
source_type: "parish_register"
source_date: "1823-03-15"
- value:
source_type: "biography"
annotations:
custodian_types: '["*"]'
specificity_score: 0.4
specificity_rationale: >-
Moderately specific - bibliographic references used across heritage research.