ClickHouse/docs/concepts

# Concepts

**What goes here:** Explanations of how ClickHouse works and what its features
are. Core mechanics (parts, merges, partitions, primary indexes), best-practice
guidance, and feature deep-dives (materialized views, dictionaries, projections,
performance, operations, configuration, security, backup/restore,
tools-and-utilities).

**Audience:** Engineers who want to understand *what* a feature is and *why* it
behaves the way it does. Not task-oriented — for "how do I do X," use `/guides`.

**Subdirectories:**
- `core-concepts/` — fundamental mechanics (parts, merges, indexes).
- `best-practices/` — opinionated must-know guidance for working with ClickHouse.
- `features/` — ClickHouse DB core features.
- `advanced-guides/` — longer-form material that doesn't fit elsewhere.

If you're adding a page that explains what something is, and how something works, it belongs here.
If you're adding step-by-step instructions of how to use a feature in practice, it belongs in `/guides`.