bakdata · philipp94831 · Jul 29, 2025 · Jul 30, 2025 · Jul 30, 2025 · Jul 30, 2025
diff --git a/docs/docs/index.md b/docs/docs/index.md
@@ -1 +1 @@
-# Coming soon
+# What is streams-bootstrap?
diff --git a/docs/docs/user/concepts/common.md b/docs/docs/user/concepts/common.md
@@ -0,0 +1,16 @@
+# Common concepts
+
+## Application types
+
+- App
+- ConfiguredApp
+- ExecutableApp
+
+## Application lifecycle
+
+- Running an application
+- Cleaning an application
+
+## Configuration
+
+## Command line interface
diff --git a/docs/docs/user/concepts/producer.md b/docs/docs/user/concepts/producer.md
@@ -0,0 +1,15 @@
+# Producer apps
+
+Producer apps are applications that generate data and send it to a Kafka topic.
+They can be used to produce messages from various sources, such as databases, files, or real-time events.
+
+## Application lifecycle
+
+- Running an application
+- Cleaning an application
+
+## Configuration
+
+## Command line interface
+
+## Deployment
diff --git a/docs/docs/user/concepts/streams.md b/docs/docs/user/concepts/streams.md
@@ -0,0 +1,36 @@
+# Streams apps
+
+Streams apps are applications that process data in real-time as it flows through Kafka topics.
+They can be used to filter, transform, aggregate, or enrich data streams.
+Streams apps can also produce new messages to other topics based on the processed data.
+
+## Application lifecycle
+
+- Running an application
+- Resetting an application
+- Cleaning an application
+
+## Configuration
+
+- Topics
+- Application id
+- Kafka properties
+- Lifecycle hooks
+    - Setup
+    - Clean up
+- Execution options
+    - On start
+        - Application server
+    - State listener
+    - Uncaught exception handler
+    - Closing options
+
+## Command line interface
+
+## Deployment
+
+## Kafka streams extensions
+
+- Simple topic access
+- Error handling
+- Serde auto configuration
diff --git a/docs/docs/user/deployment/kubernetes.md b/docs/docs/user/deployment/kubernetes.md
@@ -0,0 +1,5 @@
+# Deployment to Kubernetes
+
+- Autoscaling
+- Monitoring
+- Persistence
diff --git a/docs/docs/user/deployment/local.md b/docs/docs/user/deployment/local.md
@@ -0,0 +1 @@
+# Local deployment
diff --git a/docs/docs/user/examples/interactive-queries.md b/docs/docs/user/examples/interactive-queries.md
@@ -0,0 +1 @@
+# Interactive queries
diff --git a/docs/docs/user/examples/word-count.md b/docs/docs/user/examples/word-count.md
@@ -0,0 +1 @@
+# Word count
diff --git a/docs/docs/user/extensions/large-messages.md b/docs/docs/user/extensions/large-messages.md
@@ -0,0 +1 @@
+# Large messages
diff --git a/docs/docs/user/getting-started/quick-start.md b/docs/docs/user/getting-started/quick-start.md
@@ -0,0 +1 @@
+# Quick start
diff --git a/docs/docs/user/getting-started/setup.md b/docs/docs/user/getting-started/setup.md
@@ -0,0 +1 @@
+# Setup
diff --git a/docs/docs/user/monitoring.md b/docs/docs/user/monitoring.md
@@ -0,0 +1 @@
+# Monitoring
diff --git a/docs/docs/user/testing.md b/docs/docs/user/testing.md
@@ -0,0 +1 @@
+# Testing
diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
@@ -21,5 +21,24 @@ plugins:
 markdown_extensions:
   - attr_list
 nav:
-  - Index: index.md
+  - User guide:
+      - What is streams-bootstrap: index.md
+      - Changelog: user/changelog.md
+      - Getting Started:
+          - Setup: user/getting-started/setup.md
+          - Quick start: user/getting-started/quick-start.md
+      - Concepts:
+          - Common concepts: user/concepts/common.md
+          - Streams concepts: user/concepts/streams.md
+          - Producer concepts: user/concepts/producer.md
+      - Testing: user/testing.md
+      - Monitoring: user/monitoring.md
+      - Extensions:
+          - Large messages: user/extensions/large-messages.md
+      - Deployment:
+          - Local deployment: user/deployment/local.md
+          - Kubernetes: user/deployment/kubernetes.md
+      - Examples:
+          - Word count: user/examples/word-count.md
+          - Interactive queries: user/examples/interactive-queries.md
   - Javadoc: javadoc/index.html