chemenu/types/comparison.md

type, name, description, schema, base_dir, page_ref_fields

type	name	description	schema	base_dir	page_ref_fields
types/type-spec.md	comparison	Strukturierter Typ für Vergleichsseiten, die mehrere Entities oder Ansätze gegenüberstellen	types/comparison.schema.yaml	comparisons	entities related

Comparison

comparison ist der Typ für Seiten, die mehrere Entities, Werkzeuge, Technologien oder Ansätze systematisch anhand festgelegter Kriterien gegenüberstellen. Vergleichsseiten stützen Entscheidungen und machen Zielkonflikte zwischen Alternativen sichtbar.

Wann zu verwenden

• Vergleich mehrerer Technologien oder Frameworks für einen konkreten Einsatzzweck
• Analyse der Vor- und Nachteile verschiedener Werkzeuge oder Bibliotheken
• Bewertung alternativer Lösungswege für ein Problem
• Dokumentation eines Entscheidungsprozesses mit mehreren geprüften Optionen

Wann NICHT zu verwenden

• Für die Dokumentation einer einzelnen Entity oder eines Concepts (dann entity bzw. concept)
• Für Zusammenfassungen von Quellmaterial (dann source)
• Für Seiten, die einen einzelnen Gegenstand behandeln statt mehrere zu vergleichen

Frontmatter

Feld	Pflicht	Verwendung
type	Ja	types/comparison.md
tags	Nein	Navigations-Tags zur Kategorisierung
created	Ja	Erstellungsdatum (YYYY-MM-DD)
entities	Ja	Titel der verglichenen Entities
related	Nein	Deklarierte ausgehende Kanten - je Subjekt eine compares-with-Kante, geschrieben von wikitool xref add
summary	Ja	Einzeiler für kb/index.md

Autorenanweisungen

• Ein Titel, der den Vergleich benennt (z. B. "Go vs Rust", "Kubernetes vs Docker Swarm"); er folgt den etablierten Namen der verglichenen Gegenstände, nicht der KB-Sprache (kb/CONTRACT.md § "Titles are identifiers", kb/CONVENTIONS.md §§ "Naming" und "Language")
• Klar darlegen, was verglichen wird und warum
• Eine Vergleichstabelle mit den Kriterien als Zeilen verwenden
• Eine Analyse, die die Tabelle auswertet statt sie zu wiederholen
• Eine Empfehlung, wo eine begründbar ist

Template

# 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: bleibt als Präfix stehen - anders als bei source ist es kein title_prefix, sondern reine Template-Konvention, und der Seitentitel selbst (Go vs Rust) trägt es nicht. Fügt wikitool xref eine Beziehung hinzu, entsteht der toolgeführte Querverweis-Abschnitt; wie er heißt, entscheidet die Instanz in kb/CONVENTIONS.md (sections:).

---

Ergänzende Hinweise:

• Vergleichsseiten stützen Technologieauswahl und Architekturentscheidungen
• Die verglichenen Entities sollten alle als Wiki-Seiten existieren
• Die Kriterien sollten zur anstehenden Entscheidung passen
• Ein Vergleich bleibt auf einen konkreten Einsatzzweck oder Entscheidungskontext fokussiert