Wiki

Wiki Page Type — Comparison

Properties1
tagsllm-wiki, page-types, knowledge-management

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

Where It Lives

Put a comparison page in the comparisons/ folder of its anchor topic.

  • If both things are in the same topic, place it there
  • If it spans topics, place it under the topic the page mainly helps explain or choose within
  • If the comparison is symmetric, place it where a future reader is most likely to look first or use the optional shared wiki/comparisons/ area
  • Do not duplicate the same comparison under both topics

The shared wiki/comparisons/ area is optional, not the default. Use it only when cross-topic comparisons become common enough that topic-local placement starts feeling awkward.

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

  • [[elastic/comparisons/elastic-agent-vs-logstash]] — when to use each and how they work together
  • [[splunk/comparisons/elastic-vs-splunk-components]] — cross-topic comparison anchored under Splunk because it mainly explains Splunk roles via Elastic equivalents
  • wiki/comparisons/stacks/elastic-vs-splunk.md — example of a symmetric cross-topic comparison if a shared comparisons area is adopted later
  • [[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