glam/schemas/20251121/linkml/modules/classes/Laptop.yaml
kempersc fc405445c6 Refactor and update schema definitions
- Removed obsolete slots: `has_or_had_custodian_observation`, `provider`, and `specificity_annotation`.
- Updated `has_or_had_score` slot to use `SpecificityScore` class and modified its description and examples.
- Added new slots: `end_seconds`, `end_time`, `has_archive_path`, `has_or_had_custodian_name`, `protocol_name`, and `protocol_version`.
- Introduced a script `check_annotation_types.py` to validate the presence and structure of `custodian_types` in YAML files.
- Added a script `update_specificity.py` to automate updates related to `SpecificityAnnotation` to `SpecificityScore`.
2026-02-01 19:55:38 +01:00

122 lines
No EOL
4.7 KiB
YAML

id: https://nde.nl/ontology/hc/class/Laptop
name: laptop_class
title: Laptop Class
description: >-
Represents laptop use permission in a heritage custodian facility.
Models whether personal laptops are permitted in reading rooms
and under what conditions.
**MIGRATION NOTE** (2026-01-14):
Created as part of slot migration from `allows_laptops` and
`allows_or_allowed_laptop` to generic `allows_or_allowed` slot
with typed class. See slot_fixes.yaml for migration specification.
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
skos: http://www.w3.org/2004/02/skos/core#
imports:
- linkml:types
- ../slots/has_or_had_description
- ../slots/has_or_had_score # was: template_specificity
- ../slots/is_permitted
- ../slots/poses_or_posed_condition
- ../slots/temporal_extent # was: valid_from + valid_to
default_prefix: hc
default_range: string
classes:
Laptop:
class_uri: schema:LocationFeatureSpecification
description: >-
Permission specification for laptop use in reading rooms or study areas.
**DEFINITION**:
A policy specification indicating whether researchers may use personal
laptops when consulting materials in reading rooms.
**SCHEMA.ORG ALIGNMENT**:
Maps to `schema:LocationFeatureSpecification` as it describes an amenity
or feature availability at a location (the reading room).
**TYPICAL CONDITIONS**:
- Silent operation required
- No external keyboards/mice
- Power outlets available
- WiFi access included/separate
**TEMPORAL SEMANTICS**:
Laptop policies may change over time:
- Pre-2010: Many archives prohibited laptops
- 2010s: Most became laptop-friendly
- COVID era: Some restrictions due to spacing
**EXAMPLE**:
```yaml
allows_or_allowed:
- permitted_item: Laptop
is_permitted: true
conditions:
- "Silent operation required"
- "No external keyboards"
valid_from: "2015-01-01"
```
exact_mappings:
- schema:LocationFeatureSpecification
close_mappings:
- schema:amenityFeature
slots:
- is_permitted
- has_or_had_description
# MIGRATED 2026-01-22: condition → poses_or_posed_condition + Condition (Rule 53)
- poses_or_posed_condition
- temporal_extent # was: valid_from + valid_to
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
slot_usage:
is_permitted:
range: boolean
required: true
# MIGRATED 2026-01-22: condition → poses_or_posed_condition + Condition (Rule 53)
poses_or_posed_condition:
range: Condition
multivalued: true
inlined: true
inlined_as_list: true
annotations:
custodian_types: '["A", "L", "R", "M"]'
custodian_types_rationale: >-
Primarily relevant to archives, libraries, research centers, and museums
with reading rooms or study spaces.
custodian_types_primary: A
specificity_score: 0.75
specificity_rationale: >-
Moderately specific - applies to facilities with on-site research spaces.
comments:
- Part of reading room amenity specification system
- Replaces boolean allows_laptops and allows_or_allowed_laptop slots
- Created from slot_fixes.yaml migration (2026-01-14)
see_also:
- https://schema.org/LocationFeatureSpecification
- https://schema.org/amenityFeature
# MIGRATED 2026-01-22: condition → poses_or_posed_condition + Condition (Rule 53)
examples:
- value:
id: hc:laptop-policy/nationaal-archief
is_permitted: true
poses_or_posed_condition:
- has_or_had_type: UseCondition
has_or_had_description:
description_text: "Silent operation required"
- has_or_had_type: AmenityCondition
has_or_had_description:
description_text: "Power outlets available at each desk"
temporal_extent:
begin_of_the_begin: "2010-01-01"
- value:
id: hc:laptop-policy/special-collections-restricted
is_permitted: false
poses_or_posed_condition:
- has_or_had_type: UseCondition
has_or_had_description:
description_text: "Pencils only for note-taking"
- has_or_had_type: AmenityCondition
has_or_had_description:
description_text: "Institution-provided terminals available"
temporal_extent:
begin_of_the_begin: "2020-01-01"
# REMOVED inline slots 2026-01-16 - Rule 48 violation
# Slots are imported from ../slots/ - do not define inline