feat: merge getting started in brainpod concepts

src/background-information.md

@@ -45,7 +45,3 @@ The beauty of Brainpod is that you get all the benefits of Kubernetes without ne
 ## Cloud-Native with Brainpod
 
 Brainpod embraces cloud-native principles while keeping things simple. You build with containers, packaging your application once and running it anywhere. We ensure your app stays running so you can deploy with confidence, while automatic scaling handles traffic spikes without manual intervention. Your data stays in Europe, giving you the benefits of Dutch data sovereignty and GDPR compliance. Most importantly, we handle all the infrastructure complexity so you can focus on writing code instead of managing servers.
-
-## Next Steps
-
-- [Brainpod Concepts](brainpod.md) – Brainpod Concepts

src/custom_domains.md → src/custom-domains.md

@@ -40,7 +40,3 @@ A single route can have multiple custom domains. This is useful when you want se
 To add multiple domains, simply add each domain when creating or editing your route configuration. After deploying, configure DNS records for each domain separately in your DNS provider.
 
 Each domain gets its own TLS certificate and verification status on the Domains page. All domains on a route use the same routing rules and point to the same apps.
-
-## Next Steps
-- [Resources](resources.md) — Learn about apps and routes
-- [Getting Started](getting-started.md) — Deploy your first application

src/getting-started.md

@@ -84,9 +84,9 @@ This same workflow applies whether you're deploying your first app or updating a
 Now that you have a basic application running, explore these topics:
 
 - [Push your own images](registry.md) to Brainpod's private registry
-- [Configure apps](resources/apps.md) with environment variables and scaling
-- [Set up custom domains](resources/routes.md#hostnames-and-domains) for your routes
 - [Learn about resources](resources.md) and how apps and routes work together
+- [Configure apps](resources/apps.md) with environment variables and scaling
+- [Set up custom domains](custom-domains.md) for your routes
 
 ## Common Questions
 

src/index.md

@@ -16,8 +16,38 @@ Brainpod is a European cloud-native application platform that makes deploying an
 
 **Real-time Observability**: Application logs are captured and displayed in real-time—just write to stdout.
 
-**Dutch Infrastructure**: Your applications run on Dutch servers with a Dutch cloud provider. Built by a Dutch company, hosted in the Netherlands, ensuring full compliance with European data sovereignty requirements.
+**Dutch Infrastructure**: Your applications run on Dutch servers, ensuring full compliance with European data sovereignty requirements.
+
+## How Brainpod Works
+
+### Pods
+
+A pod is your isolated workspace within Brainpod where you deploy applications and manage infrastructure. Resources, container images, and settings are contained within your pod, allowing safe experimentation without conflicts. Multiple team members can collaborate within the same pod.
+
+### Resources
+
+We use a resource model to represent your infrastructure. Each resource is a high-level abstraction. Instead of configuring individual components, you simply define what you need and the platform handles the complexity.
+
+Currently, we support two resource types:
+
+- **[Apps](resources/apps.md)** — Your containerized applications
+- **[Routes](resources/routes.md)** — HTTP/HTTPS routing to your apps
+
+Learn more in the [Resources documentation](resources.md).
+
+### Revisions
+
+Every change to your resources creates a new revision, giving you complete version control for infrastructure changes. You can see exactly what changed, compare versions, and track the evolution of your infrastructure.
+
+When you create or modify a resource, we create a new revision in the `draft` state where you can safely make changes. Once ready, click "Deploy" and the revision moves through `waiting`, `pending`, and finally `ready` or `failed`.
+
+Previous revisions remain in history for easy rollback. Made a change that caused problems? Simply restore a previous revision to return to a known-good configuration.
+
+### Putting It Together
+
+Create a pod for your project, define resources (apps and routes), and deploy. We translate your high-level definitions into the necessary cloud infrastructure. Your team sees the complete history and can roll back when needed.
 
 ## Next Steps
 
-- [Cloud-Native Concepts](cloud-native.md) – Review the foundation
+- [Getting Started](getting-started.md) — Deploy your first application
+- [Resources](resources.md) — Learn about Apps and Routes in detail

src/registry.md

@@ -1,5 +1,5 @@
 ---
-order: 4
+order: 3
 hide_menu: false
 ---
 # Container Registry
@@ -95,6 +95,5 @@ The registry works with any tool that supports Docker registries—GitHub Action
 
 Ready to push your first image?
 
-- [API Keys](/api-keys.md) – Generate and manage API keys
 - [Getting Started](/getting-started.md) – Deploy an app using a registry image
 - [Resources](/resources.md) – Learn about Apps and Routes

src/resources.md

@@ -1,5 +1,5 @@
 ---
-order: 3
+order: 2
 hide_menu: false
 ---
 # Brainpod Resources
@@ -35,9 +35,7 @@ Routes can point to multiple apps using different path prefixes. Apps can be tar
 
 Ready to deploy your first application?
 
+- [Getting Started](getting-started.md) — Deploy your first app and route
 - [Apps](apps.md) — Deploy containerized applications
 - [Routes](routes.md) — Expose apps on the internet
-- [Getting Started](getting-started.md) — Deploy your first app and route
-- [Working with the Dashboard](dashboard.md) — Manage resources in the UI
-- [Container Registry](registry.md) — Push private images
-- [Brainpod Concepts](brainpod.md) — Review core concepts
+- [Container Registry](registry.md) — Push private images

src/resources/apps.md

@@ -30,6 +30,4 @@ Apps are designed to be stateless. For persistent data, you'll eventually be abl
 ## Next Steps
 
 - [Routes](routes.md) — Make your app accessible on the internet
-- [Getting Started](../getting-started.md) — Deploy your first app
 - [Container Registry](../registry.md) — Push private images to Brainpod
-- [Resources](../resources.md) — Overview of Brainpod resources

src/resources/routes.md

@@ -31,4 +31,4 @@ You can create multiple routes for different purposes. One route for your produc
 
 - [Apps](apps.md) — Learn about deploying containerized applications
 - [Getting Started](../getting-started.md) — Deploy your first route
-- [Resources](../resources.md) — Overview of Brainpod resources
+- [Custom Domains](../custom-domains.md) — Connect your own domain names