---
type: types/type-spec.md
name: comparison
description: Structured type for comparison pages that set several entities or approaches against one another
schema: types/comparison.schema.yaml
base_dir: comparisons
page_ref_fields: [entities, related]
guidance: types/comparison.guidance.md
---

# Comparison

This instance's configuration for the `comparison` type: its frontmatter fields as this schema
requires them, and the page skeleton `wikitool new comparison` scaffolds. When to use this type
and how to write a conforming page is [types/comparison.guidance.md](comparison.guidance.md) -
`tools/wikitool types describe comparison` composes both into one answer.

## Frontmatter

| Field | Required | Use |
|---|---:|---|
| `type` | Yes | `types/comparison.md` |
| `tags` | No | Navigation tags for categorization |
| `created` | Yes | Creation date (YYYY-MM-DD) |
| `entities` | Yes | Titles of the entities compared |
| `related` | No | Declared outbound edges - one `compares-with` edge per subject, written by `wikitool xref add` |
| `summary` | Yes | One-liner for `kb/index.md` |

## Template

The block below is page material, so it is written in this instance's KB language
(`kb/CONVENTIONS.md` `language:`) rather than in the control plane's English - its headings
become the headings of every page `wikitool new comparison` scaffolds.

```markdown
# Comparison: {name}

## Überblick

TODO: Kurzer Überblick, was verglichen wird und warum der Vergleich zählt.

## Vergleichstabelle

| Kriterium | {entities|table_header} |
|-----------|{entities|table_sep}|
| TODO | {entities|table_cells} |

## Analyse

TODO: Auswertung des Vergleichs. Welche Muster zeigen sich? Was sind die entscheidenden Unterschiede?

## Empfehlung

TODO: Falls möglich - was wann und für wen zu verwenden ist. Unter welchen Umständen ist welche Option die beste?
```

`# Comparison:` stays as a prefix - unlike `source` it is no `title_prefix` but a pure template
convention, and the page title itself (`Go vs Rust`) does not carry it. When `wikitool xref` adds
a relationship, the tool-managed cross-reference section appears; what it is called is the
instance's decision in `kb/CONVENTIONS.md` (`sections:`).