4cdf9588b2
- Added `range: string` to `connections_by_heritage_type` slot for better data representation. - Removed obsolete `data_source_whatsapp`, `data_tier`, `date_retrieved`, and `de` slots from the schema. - Updated `derived_from_observation` slot to support multiple values and changed range to `uriorcurie`. - Introduced new `DataSource` class to represent various data sources with detailed descriptions and examples. - Created `DataTierLevel` class to classify data quality tiers with standard codes and descriptions. - Archived removed slots and updated the manifest to reflect these changes. - Added new `was_retrieved_at` slot to track data retrieval timestamps, following RiC-O conventions.
204 lines
No EOL
6.9 KiB
YAML
204 lines
No EOL
6.9 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
|
|
- ../slots/link_count
|
|
# 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/was_retrieved_at # was: date_retrieved - migrated per Rule 53/56/57 (2026-01-23)
|
|
- ./Timestamp
|
|
- ../slots/specificity_annotation
|
|
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
- ./WebLink
|
|
- ./SpecificityAnnotation
|
|
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
|
|
|
|
- ./TemplateSpecificityType
|
|
|
|
- ./TemplateSpecificityTypes
|
|
- ./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
|
|
was_retrieved_at:
|
|
has_or_had_timestamp: "2025-01-14"
|
|
has_or_had_precision: 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:
|
|
- id
|
|
- name
|
|
- has_or_had_label # was: title
|
|
- description
|
|
- includes_or_included
|
|
- source_url
|
|
- 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:
|
|
id:
|
|
identifier: true
|
|
required: 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.
|
|
was_retrieved_at: # was: date_retrieved - migrated per Rule 53/56/57 (2026-01-23)
|
|
range: Timestamp
|
|
inlined: true
|
|
description: >-
|
|
Timestamp when the overview was extracted or compiled.
|
|
Uses Timestamp class for structured temporal data.
|
|
examples:
|
|
- value:
|
|
has_or_had_timestamp: "2025-01-14"
|
|
has_or_had_precision: day
|
|
description: Day-precision retrieval date
|
|
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
|
|
was_retrieved_at: # was: date_retrieved
|
|
has_or_had_timestamp: "2025-01-14"
|
|
has_or_had_precision: day
|
|
link_count: 15
|
|
description: Overview of links from a finding aid page
|
|
|
|
|
|
# REMOVED inline slots 2026-01-16 - Rule 48 violation
|
|
# Slots are imported from ../slots/ - do not define inline |