glam/schemas/20251121/linkml/modules/classes/Overview.yaml
kempersc d37a120ef2 Refactor schema definitions across multiple classes to improve clarity and consistency
- Removed unnecessary aliases and adjusted slot definitions in Timestamp, Topic, TopicType, TransferEvent, TransferPolicy, and others.
- Enhanced descriptions and added alternative language descriptions for TradeUnionArchiveRecordSetType and UnescoIchElement.
- Updated slot usage for various archive-related classes to use `equals_string` instead of `equals_expression`.
- Streamlined VideoChapter class by refining descriptions and restructuring slot usage for better navigation and organization.
- General cleanup of comments and annotations to ensure clarity and maintainability.
2026-02-16 11:17:33 +01:00

136 lines
5.1 KiB
YAML

id: https://nde.nl/ontology/hc/class/Overview
name: overview_class
title: Overview Class
description: Collection of links and related resources.
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
dcterms: http://purl.org/dc/terms/
schema: http://schema.org/
rico: https://www.ica.org/standards/RiC/ontology#
skos: http://www.w3.org/2004/02/skos/core#
imports:
- linkml:types
- ../slots/has_description
- ../slots/has_label # was: title
- ../slots/has_score # was: template_specificity
- ../slots/include
- ../slots/retrieved_at # was: date_retrieved
- ../slots/has_quantity
- ../slots/has_name
- ../slots/has_url
- ../slots/temporal_extent # was: valid_from + valid_to
default_prefix: hc
# default_range: string
classes:
Overview:
class_uri: dcterms:Collection
description: Curated collection of WebLink instances captured from a shared source or context.
comments:
- "Use cases: link collections extracted from finding-aid pages, navigation pages, or resource lists."
- "Temporal semantics: link sets can change over time; use temporal_extent and retrieved_at to qualify snapshots."
- "Migration: introduced to replace string-valued all_links with has_overview + WebLink typed structures (see slot_fixes.yaml)."
- Collection of WebLink instances
- Used with has_overview slot
- Created from slot_fixes.yaml migration (2026-01-14)
exact_mappings:
- dcterms:Collection
close_mappings:
- schema:ItemList
related_mappings:
- rico:RecordSet
slots:
- has_name
- has_label # was: title
- has_description
- include
- has_url
- retrieved_at # was: date_retrieved - migrated per Rule 53/56/57 (2026-01-23)
- link_count
- temporal_extent # was: valid_from + valid_to
- has_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
slot_usage:
has_name:
has_score:
# range: string
has_label: # was: title
# range: string
include:
# range: string
multivalued: true
inlined_as_list: false # Fixed invalid inline for primitive type
has_url:
range: uri
retrieved_at: # was: date_retrieved - migrated per Rule 53/56/57 (2026-01-23)
range: Timestamp
inlined: true
examples:
- value:
has_timestamp: "2025-01-14"
has_level: day
link_count:
range: integer
notes:
- |
Preserved from prior description (commit c2cdbed6):
Preserved from prior description (commit c2cdbed6):
A comprehensive collection of links and resources.
**DEFINITION**:
An aggregation of WebLink instances representing all links or resources
from a particular source or context. Enables structured representation
of comprehensive link collections from web pages or other sources.
**DUBLIN CORE ALIGNMENT**:
Maps to `dcterms:Collection` as it represents a collection of related
resources gathered together for a purpose.
**TEMPORAL SEMANTICS**:
Overview collections can change over time:
- New links may be added
- Existing links may be removed or updated
- The collection scope may change
**RELATIONSHIP TO INCLUDES_OR_INCLUDED**:
Uses the generic `include` slot to link to WebLink
instances, following RiC-O hierarchical patterns.
**EXAMPLE**:
annotations:
custodian_types: '["*"]'
custodian_types_rationale: >-
Applicable to all heritage custodian types as comprehensive
link collections are universal navigation patterns.
custodian_types_primary: "*"
specificity_score: 0.30
specificity_rationale: >-
Low specificity - broadly applicable for link collection
and navigation modeling.
see_also:
- http://purl.org/dc/terms/Collection
- http://schema.org/ItemList
- https://example.org/civil-registry
- https://example.org/notarial
examples:
- value:
id: hc:overview/findingaid-001-links
source_url: https://www.nationaalarchief.nl/onderzoeken/zoekhulpen/familiegeschiedenis
retrieved_at: # was: date_retrieved
has_timestamp: "2025-01-14"
has_level: day
link_count: 15
- value: |
overview:
id: hc:overview/findingaid-familyhistory-links
title: "Family History Research Links"
description: "All links from the family history finding aid page"
source_url: https://www.nationaalarchief.nl/onderzoeken/zoekhulpen/familiegeschiedenis
retrieved_at:
has_timestamp: "2025-01-14"
has_level: day
include:
- id: hc:link/civil-registry
url: https://example.org/civil-registry
link_text: "Civil Registry"
- id: hc:link/notarial-records
url: https://example.org/notarial
link_text: "Notarial Records"
# REMOVED inline slots 2026-01-16 - Rule 48 violation
# Slots are imported from ../slots/ - do not define inline