# Comment - Comment/annotation class
#
# Created per slot_fixes.yaml migration for: video_comment
# Creation date: 2026-01-14
# Updated: 2026-01-18 - comment_text migrated to has_or_had_content + Content (Rule 53/56)

id: https://nde.nl/ontology/hc/class/Comment
name: Comment
title: Comment

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/

default_prefix: hc

imports:
  - linkml:types
  - ../slots/has_or_had_content
  - ./Content
  # ADDED 2026-01-18: has_or_had_author + Author for comment_author migration (Rule 53)
  - ../slots/has_or_had_author
  - ./Author

classes:
  Comment:
    class_uri: schema:Comment
    description: |
      A comment or annotation on content.
      
      **USAGE**:
      Used for:
      - Video comments
      - Review comments
      - Annotations
      
    slots:
      # MIGRATED 2026-01-18: comment_text → has_or_had_content + Content (Rule 53/56)
      - has_or_had_content
      # MIGRATED 2026-01-18: comment_author → has_or_had_author + Author (Rule 53)
      - has_or_had_author
    
    attributes:
      # REMOVED 2026-01-18: comment_text - migrated to has_or_had_content + Content (Rule 53)
      # comment_text:
      #   range: string
      #   required: true
      #   description: Text content of the comment
      
      # REMOVED 2026-01-18: comment_author - migrated to has_or_had_author + Author (Rule 53)
      # comment_author:
      #   range: string
      #   description: Author of the comment
      
      comment_date:
        range: datetime
        description: Date/time the comment was made
      
      likes_count:
        range: integer
        description: Number of likes on the comment
    
    slot_usage:
      has_or_had_content:  # was: comment_text - migrated per Rule 53/56 (2026-01-18)
        description: |
          MIGRATED from comment_text per slot_fixes.yaml (Rule 53/56, 2026-01-18).
          Text content of the comment.
          Uses Content class with has_or_had_description for the actual text.
        range: Content
        inlined: true
        required: true
        examples:
          - value:
              has_or_had_description: "Great video about the collection!"
            description: Comment text using Content class
      has_or_had_author:  # was: comment_author - migrated per Rule 53 (2026-01-18)
        description: |
          MIGRATED from comment_author per slot_fixes.yaml (Rule 53, 2026-01-18).
          Author of the comment.
          Uses Author class for structured author representation.
        range: Author
        inlined: true
        required: false
        examples:
          - value:
              has_or_had_name: "Visitor123"
            description: Comment author using Author class
          - value:
              has_or_had_name: "MuseumFan2024"
              has_or_had_identifier: "https://youtube.com/channel/UC123"
            description: Comment author with channel identifier
    
    exact_mappings:
      - schema:Comment
    
    annotations:
      specificity_score: "0.35"
      specificity_rationale: "Low specificity - comments are common web concept."
    
    examples:
      - value:
          has_or_had_content:  # was: comment_text (2026-01-18)
            has_or_had_description: "Great video about the collection!"
          has_or_had_author:  # was: comment_author (2026-01-18)
            has_or_had_name: "Visitor123"
          comment_date: "2025-01-14T10:30:00Z"
        description: User comment on video