All checks were successful
Deploy Frontend / build-and-deploy (push) Successful in 4m31s
- Fix empty import list elements (- # comment pattern) in Laptop, Expenses, FunctionType, Overview, WebLink, Photography classes - Replace valid_from/valid_to slots with temporal_extent in class slots lists - Update slot_usage to use temporal_extent with TimeSpan range - Update examples to use temporal_extent with begin_of_the_begin/end_of_the_end - Fix typo is_or_was_is_or_was_archived_at → is_or_was_archived_at in WebObservation - Add TimeSpan imports to classes using temporal_extent - Fix relative import paths for Timestamp in temporal slots - Fix CustodianIdentifier → Identifier imports in FundingAgenda, ReadingRoomAnnex Schema validates successfully with 902 classes and 2043 slots.
189 lines
6 KiB
YAML
189 lines
6 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_comprehensive_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/id
|
|
- ../slots/name
|
|
- ../slots/description
|
|
- ../slots/has_or_had_label # was: title - migrated per Rule 53
|
|
- ../slots/includes_or_included
|
|
# ARCHIVED: ../slots/valid_from - use temporal_extent instead
|
|
# ARCHIVED: ../slots/valid_to - use temporal_extent instead
|
|
- ../slots/temporal_extent # was: valid_from + valid_to
|
|
- ../slots/source_url
|
|
- ../slots/date_retrieved
|
|
- ../slots/specificity_annotation
|
|
- ../slots/template_specificity
|
|
- ./WebLink
|
|
- ./SpecificityAnnotation
|
|
- ./TemplateSpecificityScores
|
|
- ./TimeSpan
|
|
|
|
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
|
|
date_retrieved: "2025-01-14"
|
|
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:
|
|
- id
|
|
- name
|
|
- has_or_had_label # was: title
|
|
- description
|
|
- includes_or_included
|
|
- source_url
|
|
- date_retrieved
|
|
- link_count
|
|
- temporal_extent # was: valid_from + valid_to
|
|
- specificity_annotation
|
|
- template_specificity
|
|
|
|
slot_usage:
|
|
id:
|
|
identifier: true
|
|
range: uriorcurie
|
|
name:
|
|
range: string
|
|
description: >-
|
|
Short name for the overview collection.
|
|
has_or_had_label: # was: title
|
|
range: string
|
|
description: >-
|
|
Descriptive title for the overview.
|
|
description:
|
|
range: string
|
|
description: >-
|
|
Human-readable description of the overview's purpose and scope.
|
|
includes_or_included:
|
|
range: WebLink
|
|
multivalued: true
|
|
inlined_as_list: true
|
|
description: >-
|
|
The web links included in this overview collection.
|
|
source_url:
|
|
range: uri
|
|
description: >-
|
|
The URL of the page from which links were extracted.
|
|
date_retrieved:
|
|
range: date
|
|
description: >-
|
|
Date when the overview was extracted or compiled.
|
|
link_count:
|
|
range: integer
|
|
description: >-
|
|
Total number of links in the overview.
|
|
|
|
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_comprehensive_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
|
|
title: "Family History Research Links"
|
|
description: "Comprehensive collection of links from the family history finding aid"
|
|
source_url: https://www.nationaalarchief.nl/onderzoeken/zoekhulpen/familiegeschiedenis
|
|
date_retrieved: "2025-01-14"
|
|
link_count: 15
|
|
description: Overview of links from a finding aid page
|
|
|
|
slots:
|
|
link_count:
|
|
description: >-
|
|
Total number of links in an overview collection.
|
|
range: integer
|
|
slot_uri: schema:numberOfItems
|