6c3fa6b5a3
- Deleted obsolete slot definitions for work_location and workshop_space. - Introduced new TaxonName class to represent scientific taxonomic names with detailed attributes. - Archived existing slots related to surname_prefix, target_name, taxon_name, terminal_count, text_region_count, title, title_proper, total_chapter, total_characters_extracted, total_connections_extracted, track_name, transcript_format, traveling_venue, type_label, type_status, typical_responsibility, unesco_domain, unesco_inscription_year, unesco_list_status, uniform_title, unit_name, used_by_custodian, uv_filtered_required, valid_from_geo, valid_to_geo, validation_status, variant_of_name, verification_date, viability_status, within_auxiliary_place, and within_place. - Updated slot descriptions and structures to improve clarity and compliance with standards.
188 lines
5.8 KiB
YAML
188 lines
5.8 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/valid_from
|
|
- ../slots/valid_to
|
|
- ../slots/source_url
|
|
- ../slots/date_retrieved
|
|
- ../slots/specificity_annotation
|
|
- ../slots/template_specificity
|
|
- ./WebLink
|
|
- ./SpecificityAnnotation
|
|
- ./TemplateSpecificityScores
|
|
|
|
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
|
|
- 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
|