diff --git a/docs/architecture/README.md b/docs/architecture/README.md
new file mode 100644
index 000000000..c0873135b
--- /dev/null
+++ b/docs/architecture/README.md
@@ -0,0 +1,9 @@
+# Architecture
+
+## Overview
+
+![overall architecture](overall-architecture.svg)
+
+## Example of a cross cluster setup
+
+![multi cluster setup](multi-cluster-setup.svg)
diff --git a/docs/architecture/multi-cluster-setup.svg b/docs/architecture/multi-cluster-setup.svg
new file mode 100644
index 000000000..8e9f0b6f0
--- /dev/null
+++ b/docs/architecture/multi-cluster-setup.svg
@@ -0,0 +1,33 @@
+
+
+
diff --git a/docs/architecture/overall-architecture.svg b/docs/architecture/overall-architecture.svg
new file mode 100644
index 000000000..5a3b845e3
--- /dev/null
+++ b/docs/architecture/overall-architecture.svg
@@ -0,0 +1,17 @@
+
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index 20384283d..6daa29cee 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -49,8 +49,13 @@ markdown_extensions:
nav:
- Home: README.md
- Concepts:
- - Machine Exec: concepts/machine-exec-flow.md
-- Architecture: README.md
+ - Machine Exec: concepts/machine-exec-flow.md
+- Architecture: architecture/README.md
+- Components:
+ - API Server: README.md
+ - Controller Manager: README.md
+ - Poollet: README.md
+ - Broker: README.md
- Usage: README.md
- Developer Guide:
- Local Setup: development/setup.md