---
title: [Concept name]
description: [One-sentence promise of understanding]
icon: "lightbulb"
---
# [Concept headline]
[Define the concept in one sentence.] [Add an analogy or context hook.]
<Info>
**Why it matters**
- [Impact bullet]
- [Impact bullet]
- [Impact bullet]
</Info>
## Key terms
- **[Term]** – [Short definition]
- **[Term]** – [Short definition]
{/* Optional: delete if not needed */}
```mermaid
graph LR
A[Input] */} B[Concept]
B */} C[Outcome]
```
## How does it work?
[Explain lifecycle or architecture.]
```python
# Minimal snippet that anchors the concept in code
```
<Tip>
[Nuance or best practice related to this concept.]
</Tip>
## When should you use it?
- [Scenario 1]
- [Scenario 2]
- [Scenario 3]
## How it compares
| Option | Best for | Trade-offs |
| --- | --- | --- |
| [Concept] | [Use case] | [Caveat] |
| [Alternative] | [Use case] | [Caveat] |
<Warning>
[Optional limitation or beta note.] Delete if not needed.
</Warning>
## Put it into practice
- [Operation or feature doc that relies on this concept]
- [Another supporting doc]
## See it live
- [Cookbook or integration demonstrating the concept]
- [Recording, demo, or sample repo]
{/* DEBUG: verify CTA targets */}
<CardGroup cols={2}>
<Card
title="[Feature or reference]"
description="[Why this deep dive matters]"
icon="book"
href="/[feature-link]"
/>
<Card
title="[Applied cookbook]"
description="[What they’ll build next]"
icon="rocket"
href="/[cookbook-link]"
/>
</CardGroup>
