id: https://nde.nl/ontology/hc/class/Reference
name: Reference
title: Reference Class
description: >-
  Represents a bibliographic or source reference with citation text and metadata.
  
  **USE CASES**:
  - Source citations for birth/death dates from historical documents
  - Documentary evidence supporting claims
  - Catalog or finding aid references
  
  **EXAMPLE**:
  ```yaml
  Reference:
    citation_text: "born in the year of our Lord 1823"
    source_type: "parish_register"
    source_location: "Amsterdam Stadsarchief, DTB 123"
  ```

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  dcterms: http://purl.org/dc/terms/
  schema: http://schema.org/
  bibo: http://purl.org/ontology/bibo/

default_prefix: hc

imports:
  - linkml:types
  - ../slots/has_or_had_label
  - ./Label

classes:
  Reference:
    class_uri: dcterms:BibliographicResource
    description: >-
      A bibliographic or documentary reference containing citation text
      and source metadata.
    exact_mappings:
      - dcterms:BibliographicResource
    close_mappings:
      - schema:CreativeWork
      - bibo:Document
    attributes:
      citation_text:
        range: string
        description: >-
          Verbatim text from the source document. Preserves original wording
          for archival/historical research.
        examples:
          - value: "born in the year of our Lord 1823"
          - value: "ca. 1750"
          - value: "late 18th century"
      source_type:
        range: string
        description: >-
          Type of source document (e.g., parish_register, census, 
          birth_certificate, newspaper, biography).
        examples:
          - value: "parish_register"
          - value: "census_record"
          - value: "newspaper_obituary"
      source_location:
        range: string
        description: >-
          Location or identifier of the source (e.g., archive call number,
          repository identifier, URL).
        examples:
          - value: "Amsterdam Stadsarchief, DTB 123"
          - value: "https://www.familysearch.org/ark:/12345"
      source_date:
        range: date
        description: >-
          Date of the source document (when known).
    slots:
      - has_or_had_label
    slot_usage:
      has_or_had_label:
        range: Label
        inlined: true
        description: >-
          Human-readable label for the reference.
        examples:
          - value:
              label_value: "Parish register entry for Johannes van Berg"
    examples:
      - value:
          citation_text: "born in the year of our Lord 1823"
          source_type: "parish_register"
          source_location: "Amsterdam Stadsarchief, DTB 456, folio 23r"
          source_date: "1823-03-15"
        description: Birth reference from historical parish register
      - value:
          citation_text: "ca. 1750"
          source_type: "biography"
          source_location: "Van Dale Biographical Dictionary, 1920 edition"
        description: Approximate date from biographical reference
    annotations:
      custodian_types: '["*"]'
      specificity_score: 0.4
      specificity_rationale: >-
        Moderately specific - bibliographic references used across heritage research.