diff --git a/docs/assets/agent-and-renderer.png b/docs/assets/agent-and-renderer.png
deleted file mode 100644
index b9270bb91..000000000
Binary files a/docs/assets/agent-and-renderer.png and /dev/null differ
diff --git a/docs/glossary.md b/docs/concepts/glossary.md
similarity index 96%
rename from docs/glossary.md
rename to docs/concepts/glossary.md
index 196488a11..dc34ca0b5 100644
--- a/docs/glossary.md
+++ b/docs/concepts/glossary.md
@@ -14,7 +14,18 @@ The A2UI protocol enables conversation between **agent** and **renderer**:
     - Receives **user input**, communicated by renderer
     - Updates **data** to show in UI
 
-![agent and renderer](assets/agent-and-renderer.png)
+```mermaid
+sequenceDiagram
+    participant Renderer as A2UI Renderer
+    participant Agent as A2UI Agent
+
+    Renderer->>Agent: Catalog & instructions
+
+    loop Agentic flow
+        Agent->>Renderer: Data + UI Updates. Function calls.
+        Renderer->>Agent: User input
+    end
+```
 
 While the protocol is designed for **AI-empowered agents**, it can work with deterministic agents as well. For example, an agent may return a pre-canned A2UI UI.
 
diff --git a/docs/concepts/overview.md b/docs/concepts/overview.md
index 7fb2d8d8b..dc7414db0 100644
--- a/docs/concepts/overview.md
+++ b/docs/concepts/overview.md
@@ -2,7 +2,7 @@
 
 This section explains the fundamental architecture of A2UI. Understanding these concepts will help you build effective agent-driven interfaces.
 
-See [Glossary](../glossary.md) for short definitions of key terms.
+See [Glossary](glossary.md) for short definitions of key terms.
 
 ## The Big Picture
 
diff --git a/mkdocs.yaml b/mkdocs.yaml
index 56189b06b..dd4b413ba 100644
--- a/mkdocs.yaml
+++ b/mkdocs.yaml
@@ -42,6 +42,7 @@ nav:
   - A2UI Composer ⭐: composer.md
   - Concepts:
       - Overview: concepts/overview.md
+      - Glossary: concepts/glossary.md
       - Data Flow: concepts/data-flow.md
       - Components & Structure: concepts/components.md
       - Data Binding: concepts/data-binding.md