Wikis

Wiki Page Type — Comparison

2 min read

Wiki Page Type — Comparison

A side-by-side analysis of two or more entities, concepts, or approaches to answer “which should I use?”

What It Is

A comparison page is decision-oriented. It holds structured analysis of alternatives so you don’t re-derive the tradeoffs every time a choice comes up. It answers “X vs Y — when do I pick which?”

When to Write One

  • When two entities overlap in purpose and the choice between them is non-obvious.
  • When a query answer involves tradeoffs that are worth preserving for future reference.
  • After a synthesis pass reveals that two concept pages are saying contradictory or overlapping things.

What It Contains

  • One-sentence statement of what is being compared and why
  • A summary table or parallel bullet structure (not long prose paragraphs)
  • Decision criteria: when to pick X, when to pick Y
  • Cases where both are used together
  • Links to the entity/concept pages being compared

What It Is Not

  • Not a replacement for entity pages. Each entity still gets its own page; the comparison links to both.
  • Not an overview. A comparison is narrow (X vs Y); an overview is broad (everything in a topic).
  • Not a how-to. If you’re walking through steps, write a how-to/ page.

Examples

  • [[wiki/elastic/comparisons/elastic-agent-vs-logstash]] — when to use each and how they work together
  • [[wiki/knowledge-management/concepts/llm-wiki-vs-rag]] — ingest-time vs query-time synthesis (currently filed as a concept; could live here)

See Also

Graph View

Backlinks