From 91a863050794446ec035d83f3d674d178877710f Mon Sep 17 00:00:00 2001
From: Stephan Lo <stephan.lo@telekom.de>
Date: Fri, 7 Nov 2025 14:55:53 +0100
Subject: [PATCH] feat: Add comprehensive homepage with feature cards and
 platform overview

- Add hero section with lead text and scroll-down link
- Add three feature cards: Architecture, Documentor Guide, Legacy Docs
- Add platform features section (Developer Experience, IaC, Observability)
- Add "Get Started" section with quick links for different user roles
- Use modern Docsy blocks/sections for professional appearance
---
 content/en/_index.md | 78 +++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 77 insertions(+), 1 deletion(-)

diff --git a/content/en/_index.md b/content/en/_index.md
index 3112c37..1b3429d 100644
--- a/content/en/_index.md
+++ b/content/en/_index.md
@@ -3,5 +3,81 @@ title: IPCEI-CIS Developer Framework
 ---
 
 {{< blocks/cover title="IPCEI-CIS Developer Framework" image_anchor="top" height="full" >}}
-
+<p class="lead mt-5">
+A comprehensive enterprise development platform enabling teams to build, deploy, and operate cloud-native applications with ease.
+</p>
+{{< blocks/link-down color="info" >}}
 {{< /blocks/cover >}}
+
+{{% blocks/lead color="primary" %}}
+The IPCEI-CIS Developer Framework provides everything you need to deliver modern applications at scale.
+Built on open standards and battle-tested technologies.
+{{% /blocks/lead %}}
+
+{{% blocks/section color="dark" type="row" %}}
+
+{{% blocks/feature icon="fa-solid fa-diagram-project" title="Architecture Documentation" url="/docs/architecture/" %}}
+Explore the platform's architecture with interactive C4 diagrams. Understand the system design, components, and deployment topology.
+
+**Dive into the architecture →**
+{{% /blocks/feature %}}
+
+{{% blocks/feature icon="fa-solid fa-book-open" title="Documentor Guide" url="/docs/documentation/" %}}
+Learn how to contribute to this documentation. Write content, test locally, and understand the CI/CD pipeline.
+
+**Start documenting →**
+{{% /blocks/feature %}}
+
+{{% blocks/feature icon="fa-solid fa-archive" title="Legacy Documentation (v1)" url="/docs/v1/" %}}
+Access the previous version of our documentation including historical project information and early architecture decisions.
+
+**Browse v1 docs →**
+{{% /blocks/feature %}}
+
+{{% /blocks/section %}}
+
+{{% blocks/section color="white" %}}
+
+## What's in the Platform?
+
+<div class="row">
+<div class="col-lg-4 mb-4">
+
+### 🚀 Developer Experience
+- **Backstage Portal** - Self-service platform
+- **GitOps Workflows** - Automated deployments
+- **Golden Paths** - Best practices built-in
+
+</div>
+<div class="col-lg-4 mb-4">
+
+### 🛠️ Infrastructure as Code
+- **Crossplane** - Cloud resource provisioning
+- **ArgoCD** - Declarative GitOps
+- **Terraform** - Infrastructure automation
+
+</div>
+<div class="col-lg-4 mb-4">
+
+### 📊 Observability
+- **Prometheus & Grafana** - Metrics & dashboards
+- **Loki** - Log aggregation
+- **OpenTelemetry** - Distributed tracing
+
+</div>
+</div>
+
+{{% /blocks/section %}}
+
+{{% blocks/section color="light" %}}
+
+## Get Started
+
+Whether you're a **platform engineer**, **application developer**, or **documentor**, we have resources for you:
+
+- 📖 Read the [Architecture Overview](/docs/architecture/highlevelarch/) to understand the system
+- 🏗️ Explore [Platform Components](/docs/architecture/) and their interactions
+- ✍️ Learn [How to Document](/docs/documentation/) and contribute to this site
+- 🔍 Browse [Legacy Documentation](/docs/v1/) for historical context
+
+{{% /blocks/section %}}