glam/schemas/20251121/linkml/modules/classes/AppreciationEvent.yaml
kempersc ca4a54181e Refactor schema files to improve clarity and maintainability
- Updated WorldCatIdentifier.yaml to remove unnecessary description and ensure consistent formatting.
- Enhanced WorldHeritageSite.yaml by breaking long description into multiple lines for better readability and removed unused attributes.
- Simplified WritingSystem.yaml by removing redundant attributes and ensuring consistent formatting.
- Cleaned up XPathScore.yaml by removing unnecessary attributes and ensuring consistent formatting.
- Improved YoutubeChannel.yaml by breaking long description into multiple lines for better readability.
- Enhanced YoutubeEnrichment.yaml by breaking long description into multiple lines for better readability.
- Updated YoutubeVideo.yaml to break long description into multiple lines and removed legacy field name.
- Refined has_or_had_affiliation.yaml by removing unnecessary comments and ensuring clarity.
- Cleaned up is_or_was_retrieved_at.yaml by removing unnecessary comments and ensuring clarity.
- Added rules for generic slots and avoiding rough edits in schema files to maintain structural integrity.
- Introduced changes_or_changed_through.yaml to define a new slot for linking entities to change events.
2026-01-31 00:46:23 +01:00

163 lines
4.8 KiB
YAML

id: https://nde.nl/ontology/hc/class/AppreciationEvent
name: appreciation_event_class
title: Appreciation Event Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
as: https://www.w3.org/ns/activitystreams#
prov: http://www.w3.org/ns/prov#
imports:
- linkml:types
- ../metadata
- ../slots/has_or_had_quantity
- ../slots/has_or_had_unit
- ../slots/temporal_extent
- ./Quantity
- ./TimeSpan
- ./Unit
default_prefix: hc
classes:
AppreciationEvent:
class_uri: as:Like
description: |
Appreciation or engagement event for digital content.
**PURPOSE**:
Structured representation of appreciation metrics (likes, favorites,
upvotes, reactions) for digital content such as videos, comments, and posts.
Replaces simple integer counts with rich event data.
**DESIGN RATIONALE**:
Created per slot_fixes.yaml migration from `comment_like_count` integer
to structured `is_or_was_appreciated` + `AppreciationEvent` with
`has_or_had_quantity` + `Quantity` for metric representation.
**APPRECIATION TYPES**:
| Type | Description | Platforms |
|------|-------------|-----------|
| like | Standard like/thumbs up | YouTube, Facebook, Instagram |
| favorite | Favorite/bookmark | Twitter, YouTube |
| upvote | Upvote/positive rating | Reddit, StackOverflow |
| reaction | Emoji reaction | Facebook, Slack |
| share | Share/repost | All platforms |
**ONTOLOGY ALIGNMENT**:
| Ontology | Class/Property | Usage |
|----------|----------------|-------|
| **Activity Streams** | `as:Like` | Social appreciation activity |
| **Schema.org** | `schema:InteractionCounter` | Engagement metrics |
| **PROV-O** | `prov:Activity` | Event modeling |
**EXAMPLE**:
```yaml
is_or_was_appreciated:
- appreciation_type: like
has_or_had_quantity:
numeric_value: 42
has_or_had_unit:
unit_label: "likes"
temporal_extent:
begin_of_the_begin: "2025-01-14T10:00:00Z"
```
exact_mappings:
- as:Like
close_mappings:
- schema:InteractionCounter
- prov:Activity
slots:
- has_or_had_quantity
- has_or_had_unit
- temporal_extent
attributes:
appreciation_type:
description: |
Type of appreciation (like, favorite, upvote, reaction, share).
range: string
required: true
examples:
- value: "like"
description: Standard like/thumbs up
- value: "favorite"
description: Favorite/bookmark
- value: "upvote"
description: Upvote rating
- value: "reaction"
description: Emoji reaction
- value: "share"
description: Share/repost
appreciation_count:
description: |
Simple count of appreciations (shorthand for has_or_had_quantity.numeric_value).
Use has_or_had_quantity for structured representation with unit.
range: integer
required: false
minimum_value: 0
examples:
- value: 42
description: 42 likes
slot_usage:
has_or_had_quantity:
range: integer
inlined: true
required: false
examples:
- value:
numeric_value: 42
has_or_had_unit:
unit_label: "likes"
has_or_had_unit:
range: string
inlined: true
required: false
examples:
- value:
unit_label: "likes"
temporal_extent:
range: TimeSpan
inlined: true
required: false
examples:
- value:
begin_of_the_begin: "2025-01-14T10:00:00Z"
examples:
- value:
- value:
has_or_had_quantity:
numeric_value: 42
has_or_had_unit:
unit_label: "likes"
temporal_extent:
begin_of_the_begin: "2025-01-14T10:00:00Z"
- value:
comments:
- Created 2026-01-22 from comment_like_count migration (Rule 53)
- Models appreciation metrics as structured events
- Supports multiple appreciation types (likes, favorites, etc.)
- Includes temporal observation tracking
see_also:
- https://www.w3.org/ns/activitystreams#Like
- https://schema.org/InteractionCounter
annotations:
custodian_types: '["*"]'
custodian_types_rationale: >-
Universal - any custodian with digital content may track appreciation.
specificity_score: "0.60"
specificity_rationale: >-
Moderately specific - primarily for digital content engagement contexts.