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

150 lines
No EOL
5.5 KiB
YAML

id: https://nde.nl/ontology/hc/class/Overview
name: overview_class
title: Overview Class
description: >-
A comprehensive collection of links and resources.
Represents a structured overview or collection of web links and related
resources. Used to aggregate multiple WebLink instances into a coherent
collection with shared context or purpose.
**ONTOLOGY ALIGNMENT**:
- Dublin Core: dcterms:Collection (collection of resources)
- Schema.org: schema:ItemList (list of items)
- RiC-O: rico:RecordSet (archival collection concept)
**USE CASES**:
1. All links from a finding aid page
2. Comprehensive resource listings
3. Navigation link collections
4. Related resource aggregations
**MIGRATION NOTE** (2026-01-14):
Created as part of slot migration from `all_links` to
`has_or_had_overview` with `Overview` and `WebLink` typed classes.
See slot_fixes.yaml for migration specification.
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_or_had_description
- ../slots/has_or_had_label # was: title
- ../slots/has_or_had_score # was: template_specificity
- ../slots/includes_or_included
- ../slots/is_or_was_retrieved_at # was: date_retrieved
- ../slots/link_count
- ../slots/name
- ../slots/source_url
- ../slots/specificity_annotation
- ../slots/temporal_extent # was: valid_from + valid_to
- ./SpecificityAnnotation
- ./TemplateSpecificityScore # was: TemplateSpecificityScores
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ./TimeSpan
- ./Timestamp
- ./WebLink
default_prefix: hc
default_range: string
classes:
Overview:
class_uri: dcterms:Collection
description: >-
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 `includes_or_included` slot to link to WebLink
instances, following RiC-O hierarchical patterns.
**EXAMPLE**:
```yaml
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
is_or_was_retrieved_at:
has_or_had_timestamp: "2025-01-14"
has_or_had_level: day
includes_or_included:
- 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"
```
exact_mappings:
- dcterms:Collection
close_mappings:
- schema:ItemList
- rico:RecordSet
slots:
- name
- has_or_had_label # was: title
- has_or_had_description
- includes_or_included
- source_url
- is_or_was_retrieved_at # was: date_retrieved - migrated per Rule 53/56/57 (2026-01-23)
- link_count
- temporal_extent # was: valid_from + valid_to
- specificity_annotation
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
slot_usage:
name:
range: string
has_or_had_label: # was: title
range: string
includes_or_included:
range: string
multivalued: true
inlined_as_list: true
source_url:
range: uri
is_or_was_retrieved_at: # was: date_retrieved - migrated per Rule 53/56/57 (2026-01-23)
range: Timestamp
inlined: true
examples:
- value:
has_or_had_timestamp: "2025-01-14"
has_or_had_level: day
link_count:
range: integer
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.
comments:
- Collection of WebLink instances
- Used with has_or_had_overview slot
- Created from slot_fixes.yaml migration (2026-01-14)
see_also:
- http://purl.org/dc/terms/Collection
- http://schema.org/ItemList
examples:
- value:
id: hc:overview/findingaid-001-links
source_url: https://www.nationaalarchief.nl/onderzoeken/zoekhulpen/familiegeschiedenis
is_or_was_retrieved_at: # was: date_retrieved
has_or_had_timestamp: "2025-01-14"
has_or_had_level: day
link_count: 15
# REMOVED inline slots 2026-01-16 - Rule 48 violation
# Slots are imported from ../slots/ - do not define inline