# YAML Schema for comparison type
type: object
properties:
  type:
    type: string
    const: "types/comparison.md"
    description: Must reference the comparison type-spec
  tags:
    type: array
    items:
      type: string
    description: Navigation tags for categorization
  created:
    type: string
    format: date
    pattern: "^\\d{4}-\\d{2}-\\d{2}$"
    description: Creation date in YYYY-MM-DD format
  entities:
    type: array
    items:
      type: string
    description: Entity titles being compared
    minItems: 2
  related:
    type: array
    items:
      oneOf:
        - type: string
        - type: object
          minProperties: 1
          maxProperties: 1
          additionalProperties:
            type: string
    description: >-
      Declared outbound edges, in the same shape entity and concept pages use.
      A comparison's own assertion is `compares-with` against each subject: the
      titles are already in `entities:`, but that field is the untyped
      provenance-style list, so without this one the edge the page exists to
      make would live only in hand-written prose - which is the thing
      instructions/link-taxonomy.md was built to end.
  summary:
    type: string
    description: 1-line summary for index.md
    minLength: 1
required:
  - type
  - created
  - entities
  - summary
additionalProperties: false