Wikis

Wiki Page Type — Concept

2 min read

Wiki Page Type — Concept

A page about a core idea, mechanism, or principle — something you understand rather than something you use.

What It Is

A concept page explains an abstract building block: a pattern, a mechanism, a design decision, or a mental model. It answers “how does this work?” or “what does this mean?” rather than naming a specific product or walking through steps.

When to Write One

  • When an idea recurs across multiple entities or how-tos and deserves its own explanation.
  • When understanding a topic requires grasping a non-obvious mechanism first.
  • When you want to capture “why” something is designed the way it is.

What It Contains

  • One-sentence definition at the top
  • Explanation of the idea in plain terms
  • Why it matters / what problem it solves
  • How it relates to entities that implement or rely on it
  • Cross-references to related concepts and entities

What It Is Not

  • Not an entity. If it has a product name and a vendor, it’s probably an entity.
  • Not a how-to. If it’s about doing something step by step, write a how-to/ page.
  • Not a comparison. If the point is “X vs Y”, write a comparisons/ page.

Examples

  • [[wiki/knowledge-management/concepts/llm-wiki-vs-rag]] — the tradeoff between ingest-time and query-time synthesis
  • [[wiki/ai/concepts/context-distillation]] — the idea of stripping noisy CLI output before it enters an AI context window
  • [[wiki/elastic/concepts/watcher-actions]] — how Watcher executes side effects after conditions match

See Also

Graph View

Backlinks