glam/frontend/public/schemas/20251121/linkml/modules/classes/SubGuideReference.yaml
kempersc 8a475d5c02 refactor(linkml): apply RiC-O slot naming conventions (Rule 39)
Rename slots to follow Records in Contexts (RiC-O) style naming:
- Add 'has_' prefix for possession predicates (has_acquisition_method)
- Add 'is_or_was_' prefix for temporal relationships
- Add 'has_or_had_' for bidirectional temporal relations

Key changes across 496 schema files:
- acquisition_method → has_acquisition_method
- acquisition_date → has_acquisition_date
- acquisition_source → has_acquisition_source
- access_policy_ref → has_access_policy_reference
- arrangement → has_arrangement
- parent_custodian → is_or_was_suborganization_of (hierarchy)
- parent_custodian → associated_custodian (event association)

Also adds new slots following RiC-O patterns:
- is_or_was_aggregated_by
- is_or_was_allocated_by
- is_or_was_archive_department_of
- was_approved_by, was_archived_at, was_asserted_by

This aligns with AGENTS.md Rule 39: Slot Naming Convention (RiC-O Style)
for accurate temporal semantics in heritage custodian ontology.

Net change: +2,063 lines (new slots added, old patterns consolidated)
2026-01-10 10:33:51 +01:00

111 lines
3.2 KiB
YAML

id: https://nde.nl/ontology/hc/class/SubGuideReference
name: sub_guide_reference_class
title: SubGuideReference Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
rico: https://www.ica.org/standards/RiC/ontology#
dcterms: http://purl.org/dc/terms/
default_prefix: hc
default_range: string
imports:
- linkml:types
- ../metadata
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
- ../enums/SubGuideTypeEnum
- ../slots/access_restricted
- ../slots/notes
- ../slots/slug
- ../slots/specificity_annotation
- ../slots/sub_guide_description
- ../slots/sub_guide_temporal_coverage
- ../slots/sub_guide_type
- ../slots/template_specificity
- ../slots/title_en
- ../slots/title_nl
- ../slots/url
classes:
SubGuideReference:
class_uri: rico:FindingAid
description: |
Reference to a sub-guide or related finding aid within the same repository.
Sub-guides are more specific finding aids linked from a repository guide.
For example, a "Family History" repository guide links to specific sub-guides
for "Civil Registry", "Notarial Records", etc.
slots:
- access_restricted
- notes
- slug
- specificity_annotation
- sub_guide_description
- sub_guide_temporal_coverage
- sub_guide_type
- template_specificity
- title_en
- title_nl
- url
slot_usage:
slug:
description: URL slug identifier
required: true
title_nl:
description: Dutch title
required: true
title_en:
description: English title
url:
description: Relative or absolute URL to sub-guide
required: true
sub_guide_temporal_coverage:
description: Time period covered (free text, e.g., "1811-1935", "before 1811")
sub_guide_description:
description: Brief description of the sub-guide content
sub_guide_type:
description: Type of sub-guide reference
range: SubGuideTypeEnum
is_or_was_access_restricted:
description: Whether access to this sub-guide is restricted
range: boolean
notes:
description: Additional notes about this sub-guide reference
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
exact_mappings:
- rico:isOrWasPartOf
slots:
title_nl:
slot_uri: dcterms:title
description: Dutch title
range: string
title_en:
slot_uri: dcterms:title
description: English title
range: string
sub_guide_temporal_coverage:
slot_uri: dcterms:temporal
description: Time period covered by sub-guide (free text)
range: string
examples:
- value: "1811-1935"
- value: "before 1811"
- value: "1811-present"
sub_guide_description:
slot_uri: dcterms:description
description: Brief description of sub-guide content
range: string
sub_guide_type:
slot_uri: dcterms:type
description: Type of sub-guide reference
range: SubGuideTypeEnum
is_or_was_access_restricted:
slot_uri: dcterms:accessRights
description: Whether access is restricted
range: boolean