`
+* [Developer Guide](doc/README-developer.md)
+* [Technical Writer Guide](doc/README-technical-writer.md)
+* [Release Notes](doc/RELEASE.md)
-## Project Structure
+## Project
-```
-.
-├── content/ # Documentation content (Markdown)
-│ └── en/
-│ ├── docs/ # Main documentation
-│ │ ├── architecture/ # Architecture docs with LikeC4
-│ │ ├── documentation/ # Technical Writer guides
-│ │ └── v1/ # Legacy documentation
-│ └── blog/ # Blog posts
-├── resources/ # LikeC4 architecture models
-│ ├── edp-likec4/ # Platform architecture
-│ └── doc-likec4/ # Documentation platform architecture
-├── layouts/ # Hugo templates & shortcodes
-├── assets/ # SCSS, fonts, images
-├── static/ # Static files (JS, CSS, images)
-├── Taskfile.yml # Task automation
-└── devbox.json # Devbox environment definition
-```
+This is a Hugo-based documentation site for the Edge Developer Platform, built as part of the IPCEI-CIS project.
-## Technology Stack
+**Website:** Access the documentation at the deployed URL or run locally with `task serve`
-- **[Hugo](https://gohugo.io/)** - Static site generator
-- **[Docsy](https://www.docsy.dev/)** - Documentation theme
-- **[LikeC4](https://likec4.dev/)** - Interactive architecture diagrams
-- **[Task](https://taskfile.dev/)** - Task runner
-- **[Devbox](https://www.jetify.com/devbox/)** - Development environment
-
-## Available Tasks
-
-View all tasks:
-```bash
-task --list
-```
-
-Common tasks:
-- `task serve` - Start development server
-- `task build` - Build production site
-- `task test` - Run all tests
-- `task likec4:generate` - Generate LikeC4 webcomponents
-- `task likec4:validate` - Validate LikeC4 models
-
-## Development Environments
-
-### Option 1: Devbox (Recommended)
-
-[Devbox](https://www.jetify.com/devbox/) provides an isolated, reproducible environment:
-
-```bash
-# Install Devbox (if not already installed)
-curl -fsSL https://get.jetify.com/devbox | bash
-
-# Enter the shell
-devbox shell
-
-# All tools are now available in correct versions
-hugo version
-node --version
-```
-
-### Option 2: VS Code Dev Container
-
-The `.devcontainer` folder contains the configuration for a containerized development environment:
-
-1. Open in VS Code
-2. Press `F1` → "Reopen in Container"
-3. Wait for container to build
-4. Development server starts automatically
-
-### Option 3: Manual Installation
-
-Install the following tools:
-- Hugo Extended (v0.151.0+)
-- Node.js (v24+)
-- Go (for htmltest)
-- Task (task runner)
-
-## Contributing
-
-We welcome contributions! Please:
-
-1. Read [README-technicalWriter.md](./README-technicalWriter.md) for documentation guidelines
-2. Check existing [ADRs](./content/en/docs/decisions/) for architectural context
-3. Create a branch for your changes
-4. Run `task test` before committing
-5. Submit a pull request
-
-## Documentation Guidelines
-
-- **Write in present tense** - "The system processes..." not "will process"
-- **Use architecture diagrams** - LikeC4 for interactive diagrams
-- **Keep it concise** - Readers appreciate brevity
-- **Test locally** - Run `task serve` and verify changes
-- **Update regularly** - Stale docs are worse than no docs
-
-## License
-
-[License information here]
-
-## Support
-
-- **Issues**: [Issue Tracker](https://forgejo.edf-bootstrap.cx.fg1.ffm.osc.live/DevFW/website-and-documentation/issues)
-- **Discussions**: [Forum/Chat Link]
-- **Documentation**: This repository
-
----
-
-For detailed documentation contribution guidelines, see [README-technicalWriter.md](./README-technicalWriter.md).
+For detailed information, see the documentation in the `doc/` folder.
diff --git a/Taskfile.yml b/Taskfile.yml
index 23b7b8e..e4c5aed 100644
--- a/Taskfile.yml
+++ b/Taskfile.yml
@@ -53,6 +53,14 @@ tasks:
# Test tasks
test:
desc: Run all tests
+ deps:
+ - test:build
+ - test:markdown
+ - test:html
+ - likec4:validate
+
+ test:full:
+ desc: Run all tests including link check (may have errors in legacy content)
deps:
- test:build
- test:markdown
@@ -90,9 +98,26 @@ tasks:
- "{{.NPM_CMD}} run test:html"
test:links:
- desc: Check links
+ desc: Check links (skips legacy content)
cmds:
- - htmltest
+ - |
+ # Move legacy dirs outside public temporarily
+ mkdir -p /tmp/htmltest-backup-$$
+ if [ -d "public/docs-old" ]; then mv public/docs-old /tmp/htmltest-backup-$$/; fi
+ if [ -d "public/blog" ]; then mv public/blog /tmp/htmltest-backup-$$/; fi
+ if [ -d "public/_print/docs-old" ]; then mv public/_print/docs-old /tmp/htmltest-backup-$$/docs-old-print; fi
+
+ # Run htmltest
+ htmltest || EXIT_CODE=$?
+
+ # Restore directories
+ if [ -d "/tmp/htmltest-backup-$$/docs-old" ]; then mv /tmp/htmltest-backup-$$/docs-old public/; fi
+ if [ -d "/tmp/htmltest-backup-$$/blog" ]; then mv /tmp/htmltest-backup-$$/blog public/; fi
+ if [ -d "/tmp/htmltest-backup-$$/docs-old-print" ]; then mv /tmp/htmltest-backup-$$/docs-old-print public/_print/docs-old; fi
+ rm -rf /tmp/htmltest-backup-$$
+
+ # Exit with the original exit code
+ exit ${EXIT_CODE:-0}
# LikeC4 tasks
likec4:generate:
diff --git a/content/en/_index.md b/content/en/_index.md
index bfe0aad..65102fa 100644
--- a/content/en/_index.md
+++ b/content/en/_index.md
@@ -44,25 +44,28 @@ Access the previous version of our documentation including historical project in
### 🚀 Developer Experience
-- **Backstage Portal** - Self-service platform
-- **GitOps Workflows** - Automated deployments
-- **Golden Paths** - Best practices built-in
+
+* **Backstage Portal** - Self-service platform
+* **GitOps Workflows** - Automated deployments
+* **Golden Paths** - Best practices built-in
### 🛠️ Infrastructure as Code
-- **Crossplane** - Cloud resource provisioning
-- **ArgoCD** - Declarative GitOps
-- **Terraform** - Infrastructure automation
+
+* **Crossplane** - Cloud resource provisioning
+* **ArgoCD** - Declarative GitOps
+* **Terraform** - Infrastructure automation
### 📊 Observability
-- **Prometheus & Grafana** - Metrics & dashboards
-- **Loki** - Log aggregation
-- **OpenTelemetry** - Distributed tracing
+
+* **Prometheus & Grafana** - Metrics & dashboards
+* **Loki** - Log aggregation
+* **OpenTelemetry** - Distributed tracing
@@ -75,9 +78,9 @@ Access the previous version of our documentation including historical project in
Whether you're a **platform engineer**, **application developer**, or **technicalWriter**, 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
+* 📖 Read the [Documentation](/docs/) to understand the platform
+* 🏗️ Explore [Platform Components](/docs/components/) and their usage
+* ✍️ Learn [How to Document](/docs/DOCUMENTATION-GUIDE/) and contribute
+* 🔍 Browse [Legacy Documentation](/docs-old/) for historical context
{{% /blocks/section %}}
diff --git a/content/en/docs-old/_index.md b/content/en/docs-old/_index.md
new file mode 100755
index 0000000..6c53701
--- /dev/null
+++ b/content/en/docs-old/_index.md
@@ -0,0 +1,23 @@
+---
+title: Legacy Documentation
+linkTitle: Docs (Old)
+menu:
+ main:
+ weight: 50
+weight: 50
+cascade:
+ - type: docs
+---
+
+# Legacy Documentation
+
+This section contains the previous version of the documentation for reference purposes.
+
+**Note**: This documentation is archived and may be outdated. Please refer to the main [Documentation](../docs/) section for current information.
+
+## Available Sections
+
+* [Architecture](architecture/) - System architecture and diagrams
+* [Documentation](documentation/) - Meta documentation about the documentation system
+* [Platform Overview](platform-overview/) - Overview document
+* [v1 (Legacy)](v1/) - Original v1 documentation
diff --git a/content/en/docs/architecture/_index.md b/content/en/docs-old/architecture/_index.md
similarity index 100%
rename from content/en/docs/architecture/_index.md
rename to content/en/docs-old/architecture/_index.md
diff --git a/content/en/docs/architecture/highlevelarch.md b/content/en/docs-old/architecture/highlevelarch.md
similarity index 96%
rename from content/en/docs/architecture/highlevelarch.md
rename to content/en/docs-old/architecture/highlevelarch.md
index 2119302..6f07333 100644
--- a/content/en/docs/architecture/highlevelarch.md
+++ b/content/en/docs-old/architecture/highlevelarch.md
@@ -17,7 +17,7 @@ The diagram above is interactive when viewed in a compatible browser.
You can click on components to explore the architecture details.
**Note:** The interactive diagram requires the LikeC4 webcomponent to be generated.
-See the [setup instructions]({{< ref "/docs/architecture/setup" >}}) for details.
+See the [setup instructions]({{< ref "/docs-old/architecture/setup" >}}) for details.
{{< /alert >}}
## Architecture Overview
@@ -76,4 +76,4 @@ To update or modify the architecture diagrams:
3. Commit both the model changes and the regenerated JavaScript file
-For more information, see the [LikeC4 Integration Guide]({{< ref "/docs/architecture/setup" >}}).
+For more information, see the [LikeC4 Integration Guide]({{< ref "/docs-old/architecture/setup" >}}).
diff --git a/content/en/docs/architecture/setup.md b/content/en/docs-old/architecture/setup.md
similarity index 100%
rename from content/en/docs/architecture/setup.md
rename to content/en/docs-old/architecture/setup.md
diff --git a/content/en/docs/decisions/0001-pipeline-tools.md b/content/en/docs-old/decisions/0001-pipeline-tools.md
similarity index 100%
rename from content/en/docs/decisions/0001-pipeline-tools.md
rename to content/en/docs-old/decisions/0001-pipeline-tools.md
diff --git a/content/en/docs/decisions/README.md b/content/en/docs-old/decisions/README.md
similarity index 100%
rename from content/en/docs/decisions/README.md
rename to content/en/docs-old/decisions/README.md
diff --git a/content/en/docs/decisions/_adr-template.md b/content/en/docs-old/decisions/_adr-template.md
similarity index 100%
rename from content/en/docs/decisions/_adr-template.md
rename to content/en/docs-old/decisions/_adr-template.md
diff --git a/content/en/docs/documentation/_index.md b/content/en/docs-old/documentation/_index.md
similarity index 100%
rename from content/en/docs/documentation/_index.md
rename to content/en/docs-old/documentation/_index.md
diff --git a/content/en/docs/documentation/cicd.md b/content/en/docs-old/documentation/cicd.md
similarity index 100%
rename from content/en/docs/documentation/cicd.md
rename to content/en/docs-old/documentation/cicd.md
diff --git a/content/en/docs/documentation/local-development.md b/content/en/docs-old/documentation/local-development.md
similarity index 100%
rename from content/en/docs/documentation/local-development.md
rename to content/en/docs-old/documentation/local-development.md
diff --git a/content/en/docs/documentation/publishing.md b/content/en/docs-old/documentation/publishing.md
similarity index 100%
rename from content/en/docs/documentation/publishing.md
rename to content/en/docs-old/documentation/publishing.md
diff --git a/content/en/docs/documentation/quick-reference.md b/content/en/docs-old/documentation/quick-reference.md
similarity index 100%
rename from content/en/docs/documentation/quick-reference.md
rename to content/en/docs-old/documentation/quick-reference.md
diff --git a/content/en/docs/documentation/testing.md b/content/en/docs-old/documentation/testing.md
similarity index 100%
rename from content/en/docs/documentation/testing.md
rename to content/en/docs-old/documentation/testing.md
diff --git a/content/en/docs/platform-overview.md b/content/en/docs-old/platform-overview.md
similarity index 100%
rename from content/en/docs/platform-overview.md
rename to content/en/docs-old/platform-overview.md
diff --git a/content/en/docs/v1/_index.md b/content/en/docs-old/v1/_index.md
similarity index 100%
rename from content/en/docs/v1/_index.md
rename to content/en/docs-old/v1/_index.md
diff --git a/content/en/docs/v1/concepts/1_software-and-workloads/_index.md b/content/en/docs-old/v1/concepts/1_software-and-workloads/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/1_software-and-workloads/_index.md
rename to content/en/docs-old/v1/concepts/1_software-and-workloads/_index.md
diff --git a/content/en/docs/v1/concepts/2_engineering-people/_index.md b/content/en/docs-old/v1/concepts/2_engineering-people/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/2_engineering-people/_index.md
rename to content/en/docs-old/v1/concepts/2_engineering-people/_index.md
diff --git a/content/en/docs/v1/concepts/3_use-cases/_index.md b/content/en/docs-old/v1/concepts/3_use-cases/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/3_use-cases/_index.md
rename to content/en/docs-old/v1/concepts/3_use-cases/_index.md
diff --git a/content/en/docs/v1/concepts/3_use-cases/fibonacci-app_cpu-spike.png b/content/en/docs-old/v1/concepts/3_use-cases/fibonacci-app_cpu-spike.png
similarity index 100%
rename from content/en/docs/v1/concepts/3_use-cases/fibonacci-app_cpu-spike.png
rename to content/en/docs-old/v1/concepts/3_use-cases/fibonacci-app_cpu-spike.png
diff --git a/content/en/docs/v1/concepts/3_use-cases/image.png b/content/en/docs-old/v1/concepts/3_use-cases/image.png
similarity index 100%
rename from content/en/docs/v1/concepts/3_use-cases/image.png
rename to content/en/docs-old/v1/concepts/3_use-cases/image.png
diff --git a/content/en/docs/v1/concepts/3_use-cases/platforms-def.drawio.png b/content/en/docs-old/v1/concepts/3_use-cases/platforms-def.drawio.png
similarity index 100%
rename from content/en/docs/v1/concepts/3_use-cases/platforms-def.drawio.png
rename to content/en/docs-old/v1/concepts/3_use-cases/platforms-def.drawio.png
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/_index.md b/content/en/docs-old/v1/concepts/4_digital-platforms/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/_index.md
rename to content/en/docs-old/v1/concepts/4_digital-platforms/_index.md
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/platform-components/7b748ff4-image2-1024x580.png b/content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/7b748ff4-image2-1024x580.png
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/platform-components/7b748ff4-image2-1024x580.png
rename to content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/7b748ff4-image2-1024x580.png
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/platform-components/_index.md b/content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/platform-components/_index.md
rename to content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/_index.md
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/platform-components/cicd-pipeline/_index.md b/content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/cicd-pipeline/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/platform-components/cicd-pipeline/_index.md
rename to content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/cicd-pipeline/_index.md
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/platform-components/cicd-pipeline/cicd.drawio.png b/content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/cicd-pipeline/cicd.drawio.png
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/platform-components/cicd-pipeline/cicd.drawio.png
rename to content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/cicd-pipeline/cicd.drawio.png
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/platform-components/cicd-pipeline/review-stl.md b/content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/cicd-pipeline/review-stl.md
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/platform-components/cicd-pipeline/review-stl.md
rename to content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/cicd-pipeline/review-stl.md
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/platform-components/developer-portals/_index.md b/content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/developer-portals/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/platform-components/developer-portals/_index.md
rename to content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/developer-portals/_index.md
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/platform-components/orchestrator/_index.md b/content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/orchestrator/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/platform-components/orchestrator/_index.md
rename to content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/orchestrator/_index.md
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/platform-components/references/_index.md b/content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/references/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/platform-components/references/_index.md
rename to content/en/docs-old/v1/concepts/4_digital-platforms/platform-components/references/_index.md
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/platform-engineering/Viktor-restaurant.png b/content/en/docs-old/v1/concepts/4_digital-platforms/platform-engineering/Viktor-restaurant.png
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/platform-engineering/Viktor-restaurant.png
rename to content/en/docs-old/v1/concepts/4_digital-platforms/platform-engineering/Viktor-restaurant.png
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/platform-engineering/_index.md b/content/en/docs-old/v1/concepts/4_digital-platforms/platform-engineering/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/platform-engineering/_index.md
rename to content/en/docs-old/v1/concepts/4_digital-platforms/platform-engineering/_index.md
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/platform-engineering/cortex-use-cases.png b/content/en/docs-old/v1/concepts/4_digital-platforms/platform-engineering/cortex-use-cases.png
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/platform-engineering/cortex-use-cases.png
rename to content/en/docs-old/v1/concepts/4_digital-platforms/platform-engineering/cortex-use-cases.png
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/platform-engineering/idp.webp b/content/en/docs-old/v1/concepts/4_digital-platforms/platform-engineering/idp.webp
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/platform-engineering/idp.webp
rename to content/en/docs-old/v1/concepts/4_digital-platforms/platform-engineering/idp.webp
diff --git a/content/en/docs/v1/concepts/4_digital-platforms/platform-engineering/reference-architecture/_index.md b/content/en/docs-old/v1/concepts/4_digital-platforms/platform-engineering/reference-architecture/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/4_digital-platforms/platform-engineering/reference-architecture/_index.md
rename to content/en/docs-old/v1/concepts/4_digital-platforms/platform-engineering/reference-architecture/_index.md
diff --git a/content/en/docs/v1/concepts/5_platforms/CNOE/_index.md b/content/en/docs-old/v1/concepts/5_platforms/CNOE/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/5_platforms/CNOE/_index.md
rename to content/en/docs-old/v1/concepts/5_platforms/CNOE/_index.md
diff --git a/content/en/docs/v1/concepts/5_platforms/CNOE/cnoe.png b/content/en/docs-old/v1/concepts/5_platforms/CNOE/cnoe.png
similarity index 100%
rename from content/en/docs/v1/concepts/5_platforms/CNOE/cnoe.png
rename to content/en/docs-old/v1/concepts/5_platforms/CNOE/cnoe.png
diff --git a/content/en/docs/v1/concepts/5_platforms/CNOE/local-argocd.png b/content/en/docs-old/v1/concepts/5_platforms/CNOE/local-argocd.png
similarity index 100%
rename from content/en/docs/v1/concepts/5_platforms/CNOE/local-argocd.png
rename to content/en/docs-old/v1/concepts/5_platforms/CNOE/local-argocd.png
diff --git a/content/en/docs/v1/concepts/5_platforms/CNOE/local-backstage.png b/content/en/docs-old/v1/concepts/5_platforms/CNOE/local-backstage.png
similarity index 100%
rename from content/en/docs/v1/concepts/5_platforms/CNOE/local-backstage.png
rename to content/en/docs-old/v1/concepts/5_platforms/CNOE/local-backstage.png
diff --git a/content/en/docs/v1/concepts/5_platforms/Humanitec/_index.md b/content/en/docs-old/v1/concepts/5_platforms/Humanitec/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/5_platforms/Humanitec/_index.md
rename to content/en/docs-old/v1/concepts/5_platforms/Humanitec/_index.md
diff --git a/content/en/docs/v1/concepts/5_platforms/_index.md b/content/en/docs-old/v1/concepts/5_platforms/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/5_platforms/_index.md
rename to content/en/docs-old/v1/concepts/5_platforms/_index.md
diff --git a/content/en/docs/v1/concepts/_index.md b/content/en/docs-old/v1/concepts/_index.md
similarity index 100%
rename from content/en/docs/v1/concepts/_index.md
rename to content/en/docs-old/v1/concepts/_index.md
diff --git a/content/en/docs/v1/project/MVP-12-OTC.md b/content/en/docs-old/v1/project/MVP-12-OTC.md
similarity index 100%
rename from content/en/docs/v1/project/MVP-12-OTC.md
rename to content/en/docs-old/v1/project/MVP-12-OTC.md
diff --git a/content/en/docs/v1/project/_index.md b/content/en/docs-old/v1/project/_index.md
similarity index 100%
rename from content/en/docs/v1/project/_index.md
rename to content/en/docs-old/v1/project/_index.md
diff --git a/content/en/docs/v1/project/bootstrapping/_index.md b/content/en/docs-old/v1/project/bootstrapping/_index.md
similarity index 100%
rename from content/en/docs/v1/project/bootstrapping/_index.md
rename to content/en/docs-old/v1/project/bootstrapping/_index.md
diff --git a/content/en/docs/v1/project/bootstrapping/backup/_index.md b/content/en/docs-old/v1/project/bootstrapping/backup/_index.md
similarity index 100%
rename from content/en/docs/v1/project/bootstrapping/backup/_index.md
rename to content/en/docs-old/v1/project/bootstrapping/backup/_index.md
diff --git a/content/en/docs/v1/project/conceptual-onboarding/1_intro/_index.md b/content/en/docs-old/v1/project/conceptual-onboarding/1_intro/_index.md
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/1_intro/_index.md
rename to content/en/docs-old/v1/project/conceptual-onboarding/1_intro/_index.md
diff --git a/content/en/docs/v1/project/conceptual-onboarding/2_edge-developer-framework/_index.md b/content/en/docs-old/v1/project/conceptual-onboarding/2_edge-developer-framework/_index.md
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/2_edge-developer-framework/_index.md
rename to content/en/docs-old/v1/project/conceptual-onboarding/2_edge-developer-framework/_index.md
diff --git a/content/en/docs/v1/project/conceptual-onboarding/3_platforming/_index.md b/content/en/docs-old/v1/project/conceptual-onboarding/3_platforming/_index.md
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/3_platforming/_index.md
rename to content/en/docs-old/v1/project/conceptual-onboarding/3_platforming/_index.md
diff --git a/content/en/docs/v1/project/conceptual-onboarding/3_platforming/humanitec-history.png b/content/en/docs-old/v1/project/conceptual-onboarding/3_platforming/humanitec-history.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/3_platforming/humanitec-history.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/3_platforming/humanitec-history.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/3_platforming/platform-self-services.webp b/content/en/docs-old/v1/project/conceptual-onboarding/3_platforming/platform-self-services.webp
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/3_platforming/platform-self-services.webp
rename to content/en/docs-old/v1/project/conceptual-onboarding/3_platforming/platform-self-services.webp
diff --git a/content/en/docs/v1/project/conceptual-onboarding/3_platforming/platforms-def.drawio.png b/content/en/docs-old/v1/project/conceptual-onboarding/3_platforming/platforms-def.drawio.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/3_platforming/platforms-def.drawio.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/3_platforming/platforms-def.drawio.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/3_platforming/teams.png b/content/en/docs-old/v1/project/conceptual-onboarding/3_platforming/teams.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/3_platforming/teams.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/3_platforming/teams.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/4_orchestrators/_index.md b/content/en/docs-old/v1/project/conceptual-onboarding/4_orchestrators/_index.md
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/4_orchestrators/_index.md
rename to content/en/docs-old/v1/project/conceptual-onboarding/4_orchestrators/_index.md
diff --git a/content/en/docs/v1/project/conceptual-onboarding/4_orchestrators/platform-architectures.webp b/content/en/docs-old/v1/project/conceptual-onboarding/4_orchestrators/platform-architectures.webp
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/4_orchestrators/platform-architectures.webp
rename to content/en/docs-old/v1/project/conceptual-onboarding/4_orchestrators/platform-architectures.webp
diff --git a/content/en/docs/v1/project/conceptual-onboarding/4_orchestrators/platform-tooling-humanitec-platform-report-2024.PNG b/content/en/docs-old/v1/project/conceptual-onboarding/4_orchestrators/platform-tooling-humanitec-platform-report-2024.PNG
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/4_orchestrators/platform-tooling-humanitec-platform-report-2024.PNG
rename to content/en/docs-old/v1/project/conceptual-onboarding/4_orchestrators/platform-tooling-humanitec-platform-report-2024.PNG
diff --git a/content/en/docs/v1/project/conceptual-onboarding/4_orchestrators/vendor-neutral-idp-final.gif b/content/en/docs-old/v1/project/conceptual-onboarding/4_orchestrators/vendor-neutral-idp-final.gif
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/4_orchestrators/vendor-neutral-idp-final.gif
rename to content/en/docs-old/v1/project/conceptual-onboarding/4_orchestrators/vendor-neutral-idp-final.gif
diff --git a/content/en/docs/v1/project/conceptual-onboarding/5_cnoe/_index.md b/content/en/docs-old/v1/project/conceptual-onboarding/5_cnoe/_index.md
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/5_cnoe/_index.md
rename to content/en/docs-old/v1/project/conceptual-onboarding/5_cnoe/_index.md
diff --git a/content/en/docs/v1/project/conceptual-onboarding/5_cnoe/cnoe-architecture.png b/content/en/docs-old/v1/project/conceptual-onboarding/5_cnoe/cnoe-architecture.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/5_cnoe/cnoe-architecture.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/5_cnoe/cnoe-architecture.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/5_cnoe/cnoe-capabilities.png b/content/en/docs-old/v1/project/conceptual-onboarding/5_cnoe/cnoe-capabilities.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/5_cnoe/cnoe-capabilities.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/5_cnoe/cnoe-capabilities.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/5_cnoe/cnoe-stacks.png b/content/en/docs-old/v1/project/conceptual-onboarding/5_cnoe/cnoe-stacks.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/5_cnoe/cnoe-stacks.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/5_cnoe/cnoe-stacks.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/_index.md b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/_index.md
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/_index.md
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/_index.md
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-1.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-1.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-1.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-1.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-10.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-10.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-10.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-10.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-11.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-11.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-11.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-11.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-12.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-12.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-12.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-12.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-13.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-13.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-13.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-13.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-14.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-14.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-14.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-14.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-15.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-15.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-15.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-15.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-16.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-16.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-16.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-16.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-2.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-2.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-2.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-2.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-3.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-3.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-3.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-3.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-4.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-4.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-4.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-4.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-5.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-5.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-5.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-5.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-6.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-6.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-6.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-6.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-7.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-7.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-7.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-7.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-8.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-8.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-8.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-8.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-9.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-9.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image-9.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image-9.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image.png b/content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/6_cnoe-showtime/image.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/6_cnoe-showtime/image.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/7_conclusio/README.md b/content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/README.md
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/7_conclusio/README.md
rename to content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/README.md
diff --git a/content/en/docs/v1/project/conceptual-onboarding/7_conclusio/_index.md b/content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/_index.md
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/7_conclusio/_index.md
rename to content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/_index.md
diff --git a/content/en/docs/v1/project/conceptual-onboarding/7_conclusio/domain-architecture.c4 b/content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/domain-architecture.c4
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/7_conclusio/domain-architecture.c4
rename to content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/domain-architecture.c4
diff --git a/content/en/docs/v1/project/conceptual-onboarding/7_conclusio/images/layers-and-framework-engineer.png b/content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/images/layers-and-framework-engineer.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/7_conclusio/images/layers-and-framework-engineer.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/images/layers-and-framework-engineer.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/7_conclusio/images/layers-and-platform-engineer.png b/content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/images/layers-and-platform-engineer.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/7_conclusio/images/layers-and-platform-engineer.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/images/layers-and-platform-engineer.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/7_conclusio/images/layers.png b/content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/images/layers.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/7_conclusio/images/layers.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/images/layers.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/7_conclusio/images/modern.png b/content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/images/modern.png
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/7_conclusio/images/modern.png
rename to content/en/docs-old/v1/project/conceptual-onboarding/7_conclusio/images/modern.png
diff --git a/content/en/docs/v1/project/conceptual-onboarding/_index.md b/content/en/docs-old/v1/project/conceptual-onboarding/_index.md
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/_index.md
rename to content/en/docs-old/v1/project/conceptual-onboarding/_index.md
diff --git a/content/en/docs/v1/project/conceptual-onboarding/storyline.md b/content/en/docs-old/v1/project/conceptual-onboarding/storyline.md
similarity index 100%
rename from content/en/docs/v1/project/conceptual-onboarding/storyline.md
rename to content/en/docs-old/v1/project/conceptual-onboarding/storyline.md
diff --git a/content/en/docs/v1/project/intro-stakeholder-workshop/DevOps-Lifecycle-1.jpg b/content/en/docs-old/v1/project/intro-stakeholder-workshop/DevOps-Lifecycle-1.jpg
similarity index 100%
rename from content/en/docs/v1/project/intro-stakeholder-workshop/DevOps-Lifecycle-1.jpg
rename to content/en/docs-old/v1/project/intro-stakeholder-workshop/DevOps-Lifecycle-1.jpg
diff --git a/content/en/docs/v1/project/intro-stakeholder-workshop/DevOps-Lifecycle.jpg b/content/en/docs-old/v1/project/intro-stakeholder-workshop/DevOps-Lifecycle.jpg
similarity index 100%
rename from content/en/docs/v1/project/intro-stakeholder-workshop/DevOps-Lifecycle.jpg
rename to content/en/docs-old/v1/project/intro-stakeholder-workshop/DevOps-Lifecycle.jpg
diff --git a/content/en/docs/v1/project/intro-stakeholder-workshop/_index.md b/content/en/docs-old/v1/project/intro-stakeholder-workshop/_index.md
similarity index 100%
rename from content/en/docs/v1/project/intro-stakeholder-workshop/_index.md
rename to content/en/docs-old/v1/project/intro-stakeholder-workshop/_index.md
diff --git a/content/en/docs/v1/project/intro-stakeholder-workshop/devops.png b/content/en/docs-old/v1/project/intro-stakeholder-workshop/devops.png
similarity index 100%
rename from content/en/docs/v1/project/intro-stakeholder-workshop/devops.png
rename to content/en/docs-old/v1/project/intro-stakeholder-workshop/devops.png
diff --git a/content/en/docs/v1/project/intro-stakeholder-workshop/image.png b/content/en/docs-old/v1/project/intro-stakeholder-workshop/image.png
similarity index 100%
rename from content/en/docs/v1/project/intro-stakeholder-workshop/image.png
rename to content/en/docs-old/v1/project/intro-stakeholder-workshop/image.png
diff --git a/content/en/docs/v1/project/plan-in-2024/_index.md b/content/en/docs-old/v1/project/plan-in-2024/_index.md
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/_index.md
rename to content/en/docs-old/v1/project/plan-in-2024/_index.md
diff --git a/content/en/docs/v1/project/plan-in-2024/image-2024-8-14_10-50-27.png b/content/en/docs-old/v1/project/plan-in-2024/image-2024-8-14_10-50-27.png
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/image-2024-8-14_10-50-27.png
rename to content/en/docs-old/v1/project/plan-in-2024/image-2024-8-14_10-50-27.png
diff --git a/content/en/docs/v1/project/plan-in-2024/planes.png b/content/en/docs-old/v1/project/plan-in-2024/planes.png
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/planes.png
rename to content/en/docs-old/v1/project/plan-in-2024/planes.png
diff --git a/content/en/docs/v1/project/plan-in-2024/poc/_assets/image-1.png b/content/en/docs-old/v1/project/plan-in-2024/poc/_assets/image-1.png
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/poc/_assets/image-1.png
rename to content/en/docs-old/v1/project/plan-in-2024/poc/_assets/image-1.png
diff --git a/content/en/docs/v1/project/plan-in-2024/poc/_assets/image.png b/content/en/docs-old/v1/project/plan-in-2024/poc/_assets/image.png
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/poc/_assets/image.png
rename to content/en/docs-old/v1/project/plan-in-2024/poc/_assets/image.png
diff --git a/content/en/docs/v1/project/plan-in-2024/poc/_index.md b/content/en/docs-old/v1/project/plan-in-2024/poc/_index.md
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/poc/_index.md
rename to content/en/docs-old/v1/project/plan-in-2024/poc/_index.md
diff --git a/content/en/docs/v1/project/plan-in-2024/streams/_index.md b/content/en/docs-old/v1/project/plan-in-2024/streams/_index.md
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/streams/_index.md
rename to content/en/docs-old/v1/project/plan-in-2024/streams/_index.md
diff --git a/content/en/docs/v1/project/plan-in-2024/streams/deployment/_index.md b/content/en/docs-old/v1/project/plan-in-2024/streams/deployment/_index.md
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/streams/deployment/_index.md
rename to content/en/docs-old/v1/project/plan-in-2024/streams/deployment/_index.md
diff --git a/content/en/docs/v1/project/plan-in-2024/streams/deployment/deployment.drawio.png b/content/en/docs-old/v1/project/plan-in-2024/streams/deployment/deployment.drawio.png
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/streams/deployment/deployment.drawio.png
rename to content/en/docs-old/v1/project/plan-in-2024/streams/deployment/deployment.drawio.png
diff --git a/content/en/docs/v1/project/plan-in-2024/streams/deployment/forgejo/_index.md b/content/en/docs-old/v1/project/plan-in-2024/streams/deployment/forgejo/_index.md
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/streams/deployment/forgejo/_index.md
rename to content/en/docs-old/v1/project/plan-in-2024/streams/deployment/forgejo/_index.md
diff --git a/content/en/docs/v1/project/plan-in-2024/streams/fundamentals/_index.md b/content/en/docs-old/v1/project/plan-in-2024/streams/fundamentals/_index.md
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/streams/fundamentals/_index.md
rename to content/en/docs-old/v1/project/plan-in-2024/streams/fundamentals/_index.md
diff --git a/content/en/docs/v1/project/plan-in-2024/streams/fundamentals/cicd-definition/_index.md b/content/en/docs-old/v1/project/plan-in-2024/streams/fundamentals/cicd-definition/_index.md
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/streams/fundamentals/cicd-definition/_index.md
rename to content/en/docs-old/v1/project/plan-in-2024/streams/fundamentals/cicd-definition/_index.md
diff --git a/content/en/docs/v1/project/plan-in-2024/streams/fundamentals/image.png b/content/en/docs-old/v1/project/plan-in-2024/streams/fundamentals/image.png
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/streams/fundamentals/image.png
rename to content/en/docs-old/v1/project/plan-in-2024/streams/fundamentals/image.png
diff --git a/content/en/docs/v1/project/plan-in-2024/streams/fundamentals/platform-definition/_index.md b/content/en/docs-old/v1/project/plan-in-2024/streams/fundamentals/platform-definition/_index.md
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/streams/fundamentals/platform-definition/_index.md
rename to content/en/docs-old/v1/project/plan-in-2024/streams/fundamentals/platform-definition/_index.md
diff --git a/content/en/docs/v1/project/plan-in-2024/streams/pocs/_index.md b/content/en/docs-old/v1/project/plan-in-2024/streams/pocs/_index.md
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/streams/pocs/_index.md
rename to content/en/docs-old/v1/project/plan-in-2024/streams/pocs/_index.md
diff --git a/content/en/docs/v1/project/plan-in-2024/streams/pocs/cnoe/_index.md b/content/en/docs-old/v1/project/plan-in-2024/streams/pocs/cnoe/_index.md
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/streams/pocs/cnoe/_index.md
rename to content/en/docs-old/v1/project/plan-in-2024/streams/pocs/cnoe/_index.md
diff --git a/content/en/docs/v1/project/plan-in-2024/streams/pocs/kratix/_index.md b/content/en/docs-old/v1/project/plan-in-2024/streams/pocs/kratix/_index.md
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/streams/pocs/kratix/_index.md
rename to content/en/docs-old/v1/project/plan-in-2024/streams/pocs/kratix/_index.md
diff --git a/content/en/docs/v1/project/plan-in-2024/streams/pocs/sia-asset/_index.md b/content/en/docs-old/v1/project/plan-in-2024/streams/pocs/sia-asset/_index.md
similarity index 100%
rename from content/en/docs/v1/project/plan-in-2024/streams/pocs/sia-asset/_index.md
rename to content/en/docs-old/v1/project/plan-in-2024/streams/pocs/sia-asset/_index.md
diff --git a/content/en/docs/v1/project/team-process/_assets/P1.png b/content/en/docs-old/v1/project/team-process/_assets/P1.png
similarity index 100%
rename from content/en/docs/v1/project/team-process/_assets/P1.png
rename to content/en/docs-old/v1/project/team-process/_assets/P1.png
diff --git a/content/en/docs/v1/project/team-process/_assets/P2.png b/content/en/docs-old/v1/project/team-process/_assets/P2.png
similarity index 100%
rename from content/en/docs/v1/project/team-process/_assets/P2.png
rename to content/en/docs-old/v1/project/team-process/_assets/P2.png
diff --git a/content/en/docs/v1/project/team-process/_assets/P3.png b/content/en/docs-old/v1/project/team-process/_assets/P3.png
similarity index 100%
rename from content/en/docs/v1/project/team-process/_assets/P3.png
rename to content/en/docs-old/v1/project/team-process/_assets/P3.png
diff --git a/content/en/docs/v1/project/team-process/_assets/P4.png b/content/en/docs-old/v1/project/team-process/_assets/P4.png
similarity index 100%
rename from content/en/docs/v1/project/team-process/_assets/P4.png
rename to content/en/docs-old/v1/project/team-process/_assets/P4.png
diff --git a/content/en/docs/v1/project/team-process/_assets/P5.png b/content/en/docs-old/v1/project/team-process/_assets/P5.png
similarity index 100%
rename from content/en/docs/v1/project/team-process/_assets/P5.png
rename to content/en/docs-old/v1/project/team-process/_assets/P5.png
diff --git a/content/en/docs/v1/project/team-process/_assets/P6.png b/content/en/docs-old/v1/project/team-process/_assets/P6.png
similarity index 100%
rename from content/en/docs/v1/project/team-process/_assets/P6.png
rename to content/en/docs-old/v1/project/team-process/_assets/P6.png
diff --git a/content/en/docs/v1/project/team-process/_assets/P7.png b/content/en/docs-old/v1/project/team-process/_assets/P7.png
similarity index 100%
rename from content/en/docs/v1/project/team-process/_assets/P7.png
rename to content/en/docs-old/v1/project/team-process/_assets/P7.png
diff --git a/content/en/docs/v1/project/team-process/_assets/P8.png b/content/en/docs-old/v1/project/team-process/_assets/P8.png
similarity index 100%
rename from content/en/docs/v1/project/team-process/_assets/P8.png
rename to content/en/docs-old/v1/project/team-process/_assets/P8.png
diff --git a/content/en/docs/v1/project/team-process/_assets/image.png b/content/en/docs-old/v1/project/team-process/_assets/image.png
similarity index 100%
rename from content/en/docs/v1/project/team-process/_assets/image.png
rename to content/en/docs-old/v1/project/team-process/_assets/image.png
diff --git a/content/en/docs/v1/project/team-process/_index.md b/content/en/docs-old/v1/project/team-process/_index.md
similarity index 100%
rename from content/en/docs/v1/project/team-process/_index.md
rename to content/en/docs-old/v1/project/team-process/_index.md
diff --git a/content/en/docs/v1/solution/_index.md b/content/en/docs-old/v1/solution/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/_index.md
rename to content/en/docs-old/v1/solution/_index.md
diff --git a/content/en/docs/v1/solution/design/_index.md b/content/en/docs-old/v1/solution/design/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/design/_index.md
rename to content/en/docs-old/v1/solution/design/_index.md
diff --git a/content/en/docs/v1/solution/design/architectural-documentation.md b/content/en/docs-old/v1/solution/design/architectural-documentation.md
similarity index 100%
rename from content/en/docs/v1/solution/design/architectural-documentation.md
rename to content/en/docs-old/v1/solution/design/architectural-documentation.md
diff --git a/content/en/docs/v1/solution/design/architectural-work-structure.md b/content/en/docs-old/v1/solution/design/architectural-work-structure.md
similarity index 100%
rename from content/en/docs/v1/solution/design/architectural-work-structure.md
rename to content/en/docs-old/v1/solution/design/architectural-work-structure.md
diff --git a/content/en/docs/v1/solution/design/crossplane-vs-terraform.md b/content/en/docs-old/v1/solution/design/crossplane-vs-terraform.md
similarity index 100%
rename from content/en/docs/v1/solution/design/crossplane-vs-terraform.md
rename to content/en/docs-old/v1/solution/design/crossplane-vs-terraform.md
diff --git a/content/en/docs/v1/solution/design/decision-iam-and-edf-self-containment.md b/content/en/docs-old/v1/solution/design/decision-iam-and-edf-self-containment.md
similarity index 100%
rename from content/en/docs/v1/solution/design/decision-iam-and-edf-self-containment.md
rename to content/en/docs-old/v1/solution/design/decision-iam-and-edf-self-containment.md
diff --git a/content/en/docs/v1/solution/design/platform-component.md b/content/en/docs-old/v1/solution/design/platform-component.md
similarity index 100%
rename from content/en/docs/v1/solution/design/platform-component.md
rename to content/en/docs-old/v1/solution/design/platform-component.md
diff --git a/content/en/docs/v1/solution/design/proposal-local-deployment.md b/content/en/docs-old/v1/solution/design/proposal-local-deployment.md
similarity index 100%
rename from content/en/docs/v1/solution/design/proposal-local-deployment.md
rename to content/en/docs-old/v1/solution/design/proposal-local-deployment.md
diff --git a/content/en/docs/v1/solution/design/proposal-stack-hydration.md b/content/en/docs-old/v1/solution/design/proposal-stack-hydration.md
similarity index 100%
rename from content/en/docs/v1/solution/design/proposal-stack-hydration.md
rename to content/en/docs-old/v1/solution/design/proposal-stack-hydration.md
diff --git a/content/en/docs/v1/solution/scenarios/_index.md b/content/en/docs-old/v1/solution/scenarios/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/scenarios/_index.md
rename to content/en/docs-old/v1/solution/scenarios/_index.md
diff --git a/content/en/docs/v1/solution/scenarios/gitops/_index.md b/content/en/docs-old/v1/solution/scenarios/gitops/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/scenarios/gitops/_index.md
rename to content/en/docs-old/v1/solution/scenarios/gitops/_index.md
diff --git a/content/en/docs/v1/solution/scenarios/gitops/image.png b/content/en/docs-old/v1/solution/scenarios/gitops/image.png
similarity index 100%
rename from content/en/docs/v1/solution/scenarios/gitops/image.png
rename to content/en/docs-old/v1/solution/scenarios/gitops/image.png
diff --git a/content/en/docs/v1/solution/scenarios/orchestration/_index.md b/content/en/docs-old/v1/solution/scenarios/orchestration/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/scenarios/orchestration/_index.md
rename to content/en/docs-old/v1/solution/scenarios/orchestration/_index.md
diff --git a/content/en/docs/v1/solution/scenarios/orchestration/image-1.png b/content/en/docs-old/v1/solution/scenarios/orchestration/image-1.png
similarity index 100%
rename from content/en/docs/v1/solution/scenarios/orchestration/image-1.png
rename to content/en/docs-old/v1/solution/scenarios/orchestration/image-1.png
diff --git a/content/en/docs/v1/solution/scenarios/orchestration/image.png b/content/en/docs-old/v1/solution/scenarios/orchestration/image.png
similarity index 100%
rename from content/en/docs/v1/solution/scenarios/orchestration/image.png
rename to content/en/docs-old/v1/solution/scenarios/orchestration/image.png
diff --git a/content/en/docs/v1/solution/tools/Backstage/Backstage setup tutorial/_index.md b/content/en/docs-old/v1/solution/tools/Backstage/Backstage setup tutorial/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/Backstage/Backstage setup tutorial/_index.md
rename to content/en/docs-old/v1/solution/tools/Backstage/Backstage setup tutorial/_index.md
diff --git a/content/en/docs/v1/solution/tools/Backstage/Exsisting Plugins/_index.md b/content/en/docs-old/v1/solution/tools/Backstage/Exsisting Plugins/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/Backstage/Exsisting Plugins/_index.md
rename to content/en/docs-old/v1/solution/tools/Backstage/Exsisting Plugins/_index.md
diff --git a/content/en/docs/v1/solution/tools/Backstage/General Information/_index.md b/content/en/docs-old/v1/solution/tools/Backstage/General Information/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/Backstage/General Information/_index.md
rename to content/en/docs-old/v1/solution/tools/Backstage/General Information/_index.md
diff --git a/content/en/docs/v1/solution/tools/Backstage/Plugin Creation Tutorial/_index.md b/content/en/docs-old/v1/solution/tools/Backstage/Plugin Creation Tutorial/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/Backstage/Plugin Creation Tutorial/_index.md
rename to content/en/docs-old/v1/solution/tools/Backstage/Plugin Creation Tutorial/_index.md
diff --git a/content/en/docs/v1/solution/tools/Backstage/Plugin Creation Tutorial/example_1.png b/content/en/docs-old/v1/solution/tools/Backstage/Plugin Creation Tutorial/example_1.png
similarity index 100%
rename from content/en/docs/v1/solution/tools/Backstage/Plugin Creation Tutorial/example_1.png
rename to content/en/docs-old/v1/solution/tools/Backstage/Plugin Creation Tutorial/example_1.png
diff --git a/content/en/docs/v1/solution/tools/Backstage/Plugin Creation Tutorial/example_2.png b/content/en/docs-old/v1/solution/tools/Backstage/Plugin Creation Tutorial/example_2.png
similarity index 100%
rename from content/en/docs/v1/solution/tools/Backstage/Plugin Creation Tutorial/example_2.png
rename to content/en/docs-old/v1/solution/tools/Backstage/Plugin Creation Tutorial/example_2.png
diff --git a/content/en/docs/v1/solution/tools/Backstage/_index.md b/content/en/docs-old/v1/solution/tools/Backstage/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/Backstage/_index.md
rename to content/en/docs-old/v1/solution/tools/Backstage/_index.md
diff --git a/content/en/docs/v1/solution/tools/CNOE/CNOE-competitors/_index.md b/content/en/docs-old/v1/solution/tools/CNOE/CNOE-competitors/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/CNOE-competitors/_index.md
rename to content/en/docs-old/v1/solution/tools/CNOE/CNOE-competitors/_index.md
diff --git a/content/en/docs/v1/solution/tools/CNOE/_index.md b/content/en/docs-old/v1/solution/tools/CNOE/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/_index.md
rename to content/en/docs-old/v1/solution/tools/CNOE/_index.md
diff --git a/content/en/docs/v1/solution/tools/CNOE/argocd/_index.md b/content/en/docs-old/v1/solution/tools/CNOE/argocd/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/argocd/_index.md
rename to content/en/docs-old/v1/solution/tools/CNOE/argocd/_index.md
diff --git a/content/en/docs/v1/solution/tools/CNOE/argocd/argocd-core-components.webp b/content/en/docs-old/v1/solution/tools/CNOE/argocd/argocd-core-components.webp
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/argocd/argocd-core-components.webp
rename to content/en/docs-old/v1/solution/tools/CNOE/argocd/argocd-core-components.webp
diff --git a/content/en/docs/v1/solution/tools/CNOE/argocd/argocd_architecture.webp b/content/en/docs-old/v1/solution/tools/CNOE/argocd/argocd_architecture.webp
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/argocd/argocd_architecture.webp
rename to content/en/docs-old/v1/solution/tools/CNOE/argocd/argocd_architecture.webp
diff --git a/content/en/docs/v1/solution/tools/CNOE/idpbuilder/_index.md b/content/en/docs-old/v1/solution/tools/CNOE/idpbuilder/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/idpbuilder/_index.md
rename to content/en/docs-old/v1/solution/tools/CNOE/idpbuilder/_index.md
diff --git a/content/en/docs/v1/solution/tools/CNOE/idpbuilder/hostname-routing-proxy.png b/content/en/docs-old/v1/solution/tools/CNOE/idpbuilder/hostname-routing-proxy.png
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/idpbuilder/hostname-routing-proxy.png
rename to content/en/docs-old/v1/solution/tools/CNOE/idpbuilder/hostname-routing-proxy.png
diff --git a/content/en/docs/v1/solution/tools/CNOE/idpbuilder/hostname-routing.png b/content/en/docs-old/v1/solution/tools/CNOE/idpbuilder/hostname-routing.png
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/idpbuilder/hostname-routing.png
rename to content/en/docs-old/v1/solution/tools/CNOE/idpbuilder/hostname-routing.png
diff --git a/content/en/docs/v1/solution/tools/CNOE/idpbuilder/http-routing.md b/content/en/docs-old/v1/solution/tools/CNOE/idpbuilder/http-routing.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/idpbuilder/http-routing.md
rename to content/en/docs-old/v1/solution/tools/CNOE/idpbuilder/http-routing.md
diff --git a/content/en/docs/v1/solution/tools/CNOE/idpbuilder/installation/_index.md b/content/en/docs-old/v1/solution/tools/CNOE/idpbuilder/installation/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/idpbuilder/installation/_index.md
rename to content/en/docs-old/v1/solution/tools/CNOE/idpbuilder/installation/_index.md
diff --git a/content/en/docs/v1/solution/tools/CNOE/idpbuilder/path-routing.png b/content/en/docs-old/v1/solution/tools/CNOE/idpbuilder/path-routing.png
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/idpbuilder/path-routing.png
rename to content/en/docs-old/v1/solution/tools/CNOE/idpbuilder/path-routing.png
diff --git a/content/en/docs/v1/solution/tools/CNOE/included-backstage-templates/_index.md b/content/en/docs-old/v1/solution/tools/CNOE/included-backstage-templates/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/included-backstage-templates/_index.md
rename to content/en/docs-old/v1/solution/tools/CNOE/included-backstage-templates/_index.md
diff --git a/content/en/docs/v1/solution/tools/CNOE/included-backstage-templates/basic-argo-workflow/_index.md b/content/en/docs-old/v1/solution/tools/CNOE/included-backstage-templates/basic-argo-workflow/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/included-backstage-templates/basic-argo-workflow/_index.md
rename to content/en/docs-old/v1/solution/tools/CNOE/included-backstage-templates/basic-argo-workflow/_index.md
diff --git a/content/en/docs/v1/solution/tools/CNOE/included-backstage-templates/basic-kubernetes-deployment/_idex.md b/content/en/docs-old/v1/solution/tools/CNOE/included-backstage-templates/basic-kubernetes-deployment/_idex.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/included-backstage-templates/basic-kubernetes-deployment/_idex.md
rename to content/en/docs-old/v1/solution/tools/CNOE/included-backstage-templates/basic-kubernetes-deployment/_idex.md
diff --git a/content/en/docs/v1/solution/tools/CNOE/verification.md b/content/en/docs-old/v1/solution/tools/CNOE/verification.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/CNOE/verification.md
rename to content/en/docs-old/v1/solution/tools/CNOE/verification.md
diff --git a/content/en/docs/v1/solution/tools/Crossplane/_index.md b/content/en/docs-old/v1/solution/tools/Crossplane/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/Crossplane/_index.md
rename to content/en/docs-old/v1/solution/tools/Crossplane/_index.md
diff --git a/content/en/docs/v1/solution/tools/Crossplane/provider-kind/_index.md b/content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/Crossplane/provider-kind/_index.md
rename to content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/_index.md
diff --git a/content/en/docs/v1/solution/tools/Crossplane/provider-kind/composition.drawio b/content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/composition.drawio
similarity index 100%
rename from content/en/docs/v1/solution/tools/Crossplane/provider-kind/composition.drawio
rename to content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/composition.drawio
diff --git a/content/en/docs/v1/solution/tools/Crossplane/provider-kind/composition.png b/content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/composition.png
similarity index 100%
rename from content/en/docs/v1/solution/tools/Crossplane/provider-kind/composition.png
rename to content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/composition.png
diff --git a/content/en/docs/v1/solution/tools/Crossplane/provider-kind/kindserver_interface.drawio b/content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/kindserver_interface.drawio
similarity index 100%
rename from content/en/docs/v1/solution/tools/Crossplane/provider-kind/kindserver_interface.drawio
rename to content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/kindserver_interface.drawio
diff --git a/content/en/docs/v1/solution/tools/Crossplane/provider-kind/kindserver_interface.png b/content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/kindserver_interface.png
similarity index 100%
rename from content/en/docs/v1/solution/tools/Crossplane/provider-kind/kindserver_interface.png
rename to content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/kindserver_interface.png
diff --git a/content/en/docs/v1/solution/tools/Crossplane/provider-kind/kindserver_provider-kind.drawio b/content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/kindserver_provider-kind.drawio
similarity index 100%
rename from content/en/docs/v1/solution/tools/Crossplane/provider-kind/kindserver_provider-kind.drawio
rename to content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/kindserver_provider-kind.drawio
diff --git a/content/en/docs/v1/solution/tools/Crossplane/provider-kind/kindserver_provider-kind.png b/content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/kindserver_provider-kind.png
similarity index 100%
rename from content/en/docs/v1/solution/tools/Crossplane/provider-kind/kindserver_provider-kind.png
rename to content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/kindserver_provider-kind.png
diff --git a/content/en/docs/v1/solution/tools/Crossplane/provider-kind/provider-kind_providerconfig.drawio b/content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/provider-kind_providerconfig.drawio
similarity index 100%
rename from content/en/docs/v1/solution/tools/Crossplane/provider-kind/provider-kind_providerconfig.drawio
rename to content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/provider-kind_providerconfig.drawio
diff --git a/content/en/docs/v1/solution/tools/Crossplane/provider-kind/provider-kind_providerconfig.png b/content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/provider-kind_providerconfig.png
similarity index 100%
rename from content/en/docs/v1/solution/tools/Crossplane/provider-kind/provider-kind_providerconfig.png
rename to content/en/docs-old/v1/solution/tools/Crossplane/provider-kind/provider-kind_providerconfig.png
diff --git a/content/en/docs/v1/solution/tools/Kube-prometheus-stack/_index.md b/content/en/docs-old/v1/solution/tools/Kube-prometheus-stack/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/Kube-prometheus-stack/_index.md
rename to content/en/docs-old/v1/solution/tools/Kube-prometheus-stack/_index.md
diff --git a/content/en/docs/v1/solution/tools/Loki/_index.md b/content/en/docs-old/v1/solution/tools/Loki/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/Loki/_index.md
rename to content/en/docs-old/v1/solution/tools/Loki/_index.md
diff --git a/content/en/docs/v1/solution/tools/Promtail/_index.md b/content/en/docs-old/v1/solution/tools/Promtail/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/Promtail/_index.md
rename to content/en/docs-old/v1/solution/tools/Promtail/_index.md
diff --git a/content/en/docs/v1/solution/tools/_index.md b/content/en/docs-old/v1/solution/tools/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/_index.md
rename to content/en/docs-old/v1/solution/tools/_index.md
diff --git a/content/en/docs/v1/solution/tools/kyverno integration/_index.md b/content/en/docs-old/v1/solution/tools/kyverno integration/_index.md
similarity index 100%
rename from content/en/docs/v1/solution/tools/kyverno integration/_index.md
rename to content/en/docs-old/v1/solution/tools/kyverno integration/_index.md
diff --git a/content/en/docs/v1/solution/tools/kyverno integration/kyverno.png b/content/en/docs-old/v1/solution/tools/kyverno integration/kyverno.png
similarity index 100%
rename from content/en/docs/v1/solution/tools/kyverno integration/kyverno.png
rename to content/en/docs-old/v1/solution/tools/kyverno integration/kyverno.png
diff --git a/content/en/docs/DOCUMENTATION-GUIDE.md b/content/en/docs/DOCUMENTATION-GUIDE.md
new file mode 100644
index 0000000..e1b1a36
--- /dev/null
+++ b/content/en/docs/DOCUMENTATION-GUIDE.md
@@ -0,0 +1,204 @@
+---
+title: "Documentation Guide"
+linkTitle: "Documentation Guide"
+weight: 100
+description: >
+ Guidelines and templates for creating EDP documentation.
+---
+
+## Purpose
+
+This guide helps team members create consistent, high-quality documentation for the Edge Developer Platform. The documentation serves developers, engineers, and auditors who need to understand and use the platform.
+
+## Documentation Principles
+
+### Focus on Outcomes
+
+* Describe what the platform does and how to use it
+* Emphasize practical usage over implementation details
+* Include links to repositories for deeper technical information
+
+### Write for the Audience
+
+* **Developers**: How to use the platform, deploy applications, integrate services
+* **Engineers**: Architecture, operational procedures, troubleshooting
+* **Auditors**: Project history, decisions, compliance information
+
+### Keep It Concise
+
+* Top-down approach: start with overview, drill down as needed
+* Less is more - avoid deep nested structures
+* Use templates to maintain consistency
+
+### Maintain Quality
+
+* Use present tense ("The system processes..." not "will process")
+* Keep information up to date
+* Test examples and procedures before documenting
+* Run `task test` before committing changes
+
+## Documentation Structure
+
+The EDP documentation is organized into five main sections:
+
+### 1. Platform Overview
+
+High-level introduction to EDP, target audience, purpose, and product structure.
+
+**Content focus**: Why EDP exists, who uses it, what it provides
+
+### 2. Components
+
+Detailed documentation for each platform component.
+
+**Content focus**: What each component does, how to use it, integration points
+
+**Template**: Use `components/TEMPLATE.md` as starting point
+
+### 3. Getting Started
+
+Onboarding guides and quick start instructions.
+
+**Content focus**: Prerequisites, step-by-step setup, first application deployment
+
+### 4. Operations
+
+Deployment, monitoring, troubleshooting, and maintenance procedures.
+
+**Content focus**: How to operate the platform, resolve issues, maintain health
+
+### 5. Governance
+
+Project history, architecture decisions, compliance, and audit information.
+
+**Content focus**: Why decisions were made, project evolution, external relations
+
+## Writing Documentation
+
+### Using Templates
+
+Templates are provided for common documentation types:
+
+* **Component Documentation**: `content/en/docs/components/TEMPLATE.md`
+* Review existing component pages for examples (Forgejo, Kubernetes, Backstage)
+
+### Frontmatter
+
+Every markdown file starts with YAML frontmatter:
+
+```yaml
+---
+title: "Full Page Title"
+linkTitle: "Short Nav Title"
+weight: 10
+description: >
+ Brief description for search and previews.
+---
+```
+
+* **title**: Full page title (appears in page header)
+* **linkTitle**: Shorter title for navigation menu
+* **weight**: Sort order (lower numbers appear first)
+* **description**: Brief summary for SEO and page previews
+
+### Content Structure
+
+Follow this pattern for component documentation:
+
+1. **Overview**: What it is and what it does
+2. **Key Features**: Bullet list of main capabilities
+3. **Purpose in EDP**: Why it's part of the platform
+4. **Getting Started**: Quick start guide
+5. **Usage Examples**: Common scenarios
+6. **Integration Points**: How it connects to other components
+7. **Status**: Current maturity level
+8. **Documentation Notes**: Instructions for filling in details (remove when complete)
+
+### Markdown Style
+
+* Use `*` for bullet lists (not `-`)
+* Add blank lines around headings and lists
+* Specify language for code blocks: ` ```bash ` or ` ```yaml `
+* Use relative links for internal pages
+
+### Including Code Examples
+
+Always specify the language:
+
+```bash
+# Good example
+task serve
+```
+
+```yaml
+# Configuration example
+apiVersion: v1
+kind: Service
+```
+
+## Testing Documentation
+
+Before committing changes:
+
+```bash
+# Run all tests
+task test
+
+# Build site locally
+task build
+
+# Preview changes
+task serve
+```
+
+The test suite checks:
+
+* Markdown syntax (markdownlint)
+* HTML validity
+* Broken links
+* Hugo build success
+
+## Adding New Sections
+
+When adding a new documentation section:
+
+1. Create directory: `content/en/docs/[section-name]/`
+2. Create index file: `_index.md` with frontmatter
+3. Add weight to control sort order
+4. Update navigation in parent `_index.md` if needed
+5. Test with `task test`
+
+## Tips for Good Documentation
+
+### Do
+
+* Write clearly and concisely
+* Use examples and code samples
+* Include links to repositories and external resources
+* Update documentation when features change
+* Test procedures before documenting them
+* Use templates for consistency
+
+### Don't
+
+* Create deep nested structures (keep it flat)
+* Document implementation details extensively (link to code instead)
+* Use future tense ("will do" → "does")
+* Add documentation for incomplete features
+* Forget to test your changes
+
+## Getting Help
+
+For questions about documentation:
+
+* Check existing pages for examples
+* Review `doc/README-technical-writer.md` for Hugo/Docsy details
+* Ask team members for review before committing
+* Use `task serve` to preview changes locally
+
+## Reference
+
+* **Main README**: `/doc/README-technical-writer.md`
+* **Component Template**: `/content/en/docs/components/TEMPLATE.md`
+* **Hugo Documentation**:
+* **Docsy Theme**:
diff --git a/content/en/docs/_index.md b/content/en/docs/_index.md
old mode 100755
new mode 100644
index 6237f22..c5ab604
--- a/content/en/docs/_index.md
+++ b/content/en/docs/_index.md
@@ -1,8 +1,31 @@
---
-title: Developer Framework Documentation
-linkTitle: Docs
-menu: {main: {weight: 20}}
-weight: 20
+title: "Documentation"
+linkTitle: "Documentation"
+menu:
+ main:
+ weight: 20
---
-This section is the project documentation for IPCEI-CIS Developer Framework.
+# Edge Developer Platform (EDP) Documentation
+
+Welcome to the EDP documentation. This documentation serves developers, engineers, and auditors who want to understand, use, and audit the Edge Developer Platform.
+
+## Target Audience
+
+* **Developers & Engineers**: Learn how to use the platform, deploy applications, and integrate services
+* **Platform Engineers**: Understand the architecture, components, and operational aspects
+* **Auditors & Governance**: Access project history, decisions, and compliance information
+
+## Documentation Structure
+
+The documentation follows a top-down approach focusing on outcomes and practical usage:
+
+* **Platform Overview**: High-level introduction and product structure
+* **Components**: Individual platform components and their usage
+* **Getting Started**: Onboarding and quick start guides
+* **Operations**: Deployment, monitoring, and troubleshooting
+* **Governance**: Project history, decisions, and compliance
+
+## Purpose
+
+This documentation describes the outcomes and products of the edgeDeveloperFramework (eDF) project. The EDP is designed as a usable, integrated platform with clear links to repositories and implementation details.
diff --git a/content/en/docs/components/TEMPLATE.md b/content/en/docs/components/TEMPLATE.md
new file mode 100644
index 0000000..d983a8f
--- /dev/null
+++ b/content/en/docs/components/TEMPLATE.md
@@ -0,0 +1,102 @@
+---
+title: "[Component Name]"
+linkTitle: "[Short Name]"
+weight: 99
+description: >
+ [Brief one-line description of the component]
+---
+
+## Overview
+
+[Detailed description of the component - what it is, what it does, and why it exists]
+
+## Key Features
+
+* [Feature 1]
+* [Feature 2]
+* [Feature 3]
+
+## Purpose in EDP
+
+[Explain the role this component plays in the Edge Developer Platform and how it contributes to the overall platform capabilities]
+
+## Architecture
+
+[Optional: Brief architecture overview or link to detailed architecture documentation]
+
+## Repository
+
+**Code**: [Link to source code repository]
+
+**Documentation**: [Link to component-specific documentation]
+
+## Getting Started
+
+### Prerequisites
+
+* [Prerequisite 1]
+* [Prerequisite 2]
+
+### Quick Start
+
+[Step-by-step guide to get started with this component]
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+### Verification
+
+[How to verify the component is working correctly]
+
+## Usage Examples
+
+### [Use Case 1]
+
+[Example with code/commands showing common use case]
+
+```bash
+# Example commands
+```
+
+### [Use Case 2]
+
+[Another common scenario]
+
+## Integration Points
+
+* **[Component A]**: [How it integrates]
+* **[Component B]**: [How it integrates]
+* **[Component C]**: [How it integrates]
+
+## Configuration
+
+[Key configuration options and how to set them]
+
+## Troubleshooting
+
+### [Common Issue 1]
+
+**Problem**: [Description]
+
+**Solution**: [How to fix]
+
+### [Common Issue 2]
+
+**Problem**: [Description]
+
+**Solution**: [How to fix]
+
+## Status
+
+**Maturity**: [Production / Beta / Experimental]
+
+## Additional Resources
+
+* [Link to external documentation]
+* [Link to community resources]
+* [Link to related components]
+
+## Documentation Notes
+
+[Instructions for team members filling in this documentation - remove this section once complete]
diff --git a/content/en/docs/components/_index.md b/content/en/docs/components/_index.md
new file mode 100644
index 0000000..977030a
--- /dev/null
+++ b/content/en/docs/components/_index.md
@@ -0,0 +1,74 @@
+---
+title: "Components"
+linkTitle: "Components"
+weight: 2
+description: >
+ Overview of EDP platform components and their integration.
+---
+
+## Component Overview
+
+The Edge Developer Platform consists of multiple integrated components. Each component serves specific purposes in the overall platform architecture.
+
+This section provides detailed documentation for each component, including:
+
+* Description and purpose
+* Key features and capabilities
+* Repository links and resources
+* Usage instructions and examples
+* Integration points with other components
+
+## Core Components
+
+### Source Code Management
+
+**Forgejo**: Self-hosted Git service with repository management, issue tracking, and collaboration features.
+
+**GitLab**: Enterprise-grade Git repository management with CI/CD integration.
+
+### Container Orchestration
+
+**Kubernetes**: Container orchestration platform for deploying and managing containerized applications.
+
+### CI/CD & Automation
+
+**Woodpecker**: Lightweight CI/CD server with pipeline automation.
+
+**GARM**: GitHub Actions-compatible runner manager for self-hosted environments.
+
+**ArgoCD**: GitOps continuous delivery tool for Kubernetes.
+
+### Developer Portal
+
+**Backstage**: Developer portal providing unified interface for platform services, documentation, and tooling.
+
+### Observability
+
+**VictoriaMetrics**: Time-series database for metrics storage and querying.
+
+**Prometheus**: Metrics collection and alerting.
+
+**Grafana**: Visualization and dashboards for metrics and logs.
+
+### Infrastructure as Code
+
+**Terraform**: Infrastructure provisioning and management.
+
+**Crossplane**: Kubernetes-native infrastructure management.
+
+## Component Status
+
+Each component page includes current status and maturity level. Check individual component documentation for detailed information.
+
+## Template for Component Documentation
+
+When documenting a component, include:
+
+1. **Overview**: Brief description and purpose
+2. **Key Features**: Main capabilities and use cases
+3. **Architecture**: How it fits into EDP
+4. **Getting Started**: Quick start guide
+5. **Usage Examples**: Common scenarios and patterns
+6. **Repository**: Link to source code and additional resources
+7. **Integration**: Connection points with other components
+8. **Status**: Current maturity level
diff --git a/content/en/docs/components/backstage.md b/content/en/docs/components/backstage.md
new file mode 100644
index 0000000..18d433e
--- /dev/null
+++ b/content/en/docs/components/backstage.md
@@ -0,0 +1,49 @@
+---
+title: "Backstage"
+linkTitle: "Backstage"
+weight: 3
+description: >
+ Developer portal providing unified access to platform services and documentation.
+---
+
+## Overview
+
+Backstage provides a central developer portal for the EDP, offering unified access to services, documentation, and platform capabilities.
+
+## Key Features
+
+* Service catalog and component registry
+* Software templates for rapid application creation
+* Documentation hub
+* Kubernetes visualization
+* API documentation
+* Plugin ecosystem for extensibility
+
+## Purpose in EDP
+
+Backstage serves as the entry point for developers, providing discoverability of platform capabilities and streamlined workflows.
+
+## Getting Started
+
+[To be documented: How to access and use Backstage portal]
+
+## Integration Points
+
+* **Forgejo/GitLab**: Repository and CI/CD integration
+* **Kubernetes**: Resource visualization and management
+* **ArgoCD**: Deployment status and controls
+* **Documentation**: Centralized doc access
+
+## Status
+
+**Maturity**: Beta
+
+## Documentation Notes
+
+This is a template page. Team members should fill in:
+
+* Access URL and authentication
+* Available plugins and features
+* Creating new components from templates
+* Service catalog usage
+* Customization options
diff --git a/content/en/docs/components/forgejo.md b/content/en/docs/components/forgejo.md
new file mode 100644
index 0000000..349995b
--- /dev/null
+++ b/content/en/docs/components/forgejo.md
@@ -0,0 +1,54 @@
+---
+title: "Forgejo"
+linkTitle: "Forgejo"
+weight: 1
+description: >
+ Self-hosted Git service with repository management and collaboration features.
+---
+
+## Overview
+
+Forgejo is a self-hosted Git service that provides repository management, issue tracking, pull requests, and collaboration features. It serves as a core component of the EDP for source code management.
+
+## Key Features
+
+* Git repository hosting
+* Issue tracking and project management
+* Pull requests and code review
+* CI/CD integration with Woodpecker
+* User and organization management
+* API for automation and integration
+
+## Purpose in EDP
+
+Forgejo serves as the primary source code management platform, providing developers with a familiar Git workflow while maintaining full control over the hosting infrastructure.
+
+## Repository
+
+**Code**: [Link to Forgejo repository]
+
+**Documentation**: [Link to Forgejo-specific documentation]
+
+## Getting Started
+
+[To be documented: Quick start guide for using Forgejo in EDP]
+
+## Integration Points
+
+* **Woodpecker CI**: Automated pipeline triggers on git events
+* **ArgoCD**: GitOps repository source
+* **Backstage**: Service catalog integration
+
+## Status
+
+**Maturity**: Production
+
+## Documentation Notes
+
+This is a template page. Team members should fill in:
+
+* Specific deployment details
+* Access URLs and credentials management
+* Common workflows and usage patterns
+* Troubleshooting information
+* Screenshots or examples
diff --git a/content/en/docs/components/kubernetes.md b/content/en/docs/components/kubernetes.md
new file mode 100644
index 0000000..f112752
--- /dev/null
+++ b/content/en/docs/components/kubernetes.md
@@ -0,0 +1,48 @@
+---
+title: "Kubernetes"
+linkTitle: "Kubernetes"
+weight: 2
+description: >
+ Container orchestration platform for deploying and managing applications.
+---
+
+## Overview
+
+Kubernetes provides the foundation for container orchestration in the EDP, enabling deployment, scaling, and management of containerized applications.
+
+## Key Features
+
+* Container orchestration and scheduling
+* Service discovery and load balancing
+* Storage orchestration
+* Self-healing and automated rollouts
+* Configuration and secret management
+
+## Purpose in EDP
+
+Kubernetes serves as the runtime platform for all EDP components and user applications, providing standardized deployment and operations.
+
+## Getting Started
+
+[To be documented: Quick start for deploying to Kubernetes in EDP]
+
+## Integration Points
+
+* **ArgoCD**: Kubernetes deployment automation
+* **Crossplane**: Infrastructure provisioning on Kubernetes
+* **VictoriaMetrics/Prometheus**: Kubernetes metrics collection
+* **Backstage**: Kubernetes resource visualization
+
+## Status
+
+**Maturity**: Production
+
+## Documentation Notes
+
+This is a template page. Team members should fill in:
+
+* Cluster access procedures
+* Namespace organization
+* Resource quotas and limits
+* Network policies
+* Storage classes and PV management
diff --git a/content/en/docs/getting-started/_index.md b/content/en/docs/getting-started/_index.md
new file mode 100644
index 0000000..59fb0b9
--- /dev/null
+++ b/content/en/docs/getting-started/_index.md
@@ -0,0 +1,57 @@
+---
+title: "Getting Started"
+linkTitle: "Getting Started"
+weight: 3
+description: >
+ Quick start guides and onboarding information for the Edge Developer Platform.
+---
+
+## Welcome to EDP
+
+This section helps you get started with the Edge Developer Platform, whether you're a developer building applications or a platform engineer managing infrastructure.
+
+## Quick Start for Developers
+
+### Prerequisites
+
+* Access to EDP instance
+* Git client installed
+* kubectl configured (for Kubernetes access)
+* Basic knowledge of containers and CI/CD
+
+### Your First Application
+
+1. **Access the Platform**: Log in to Backstage portal
+2. **Clone Repository**: Get your application repository from Forgejo/GitLab
+3. **Configure Pipeline**: Set up CI/CD in Woodpecker or ArgoCD
+4. **Deploy**: Push code and watch automated deployment
+
+### Next Steps
+
+* Explore available components and services
+* Review platform documentation and best practices
+* Join the developer community
+
+## Quick Start for Platform Engineers
+
+### Platform Access
+
+* Kubernetes cluster access
+* Infrastructure management tools
+* Monitoring and observability dashboards
+
+### Key Resources
+
+* Platform architecture documentation
+* Operational runbooks
+* Troubleshooting guides
+
+## Documentation Template
+
+When creating "Getting Started" content for a component:
+
+1. **Prerequisites**: What users need before starting
+2. **Step-by-Step Guide**: Clear, numbered instructions
+3. **Verification**: How to confirm success
+4. **Common Issues**: FAQ and troubleshooting
+5. **Next Steps**: Links to deeper documentation
diff --git a/content/en/docs/governance/_index.md b/content/en/docs/governance/_index.md
new file mode 100644
index 0000000..d33b745
--- /dev/null
+++ b/content/en/docs/governance/_index.md
@@ -0,0 +1,67 @@
+---
+title: "Governance"
+linkTitle: "Governance"
+weight: 5
+description: >
+ Project history, architecture decisions, compliance, and audit information.
+---
+
+## Governance Overview
+
+This section provides information for auditors, governance teams, and stakeholders who need to understand the project's decision-making process, history, and compliance.
+
+## Architecture Decision Records (ADRs)
+
+Documentation of significant architectural decisions made during the project, including context, options considered, and rationale.
+
+## Project History
+
+### Development Process
+
+The EDP was developed using collaborative approaches including mob programming and iterative development with regular user feedback.
+
+### Project Phases
+
+* Research & Design
+* Proof of Concept
+* Friendly User Phase
+* Production Rollout
+
+### Deliverables Mapping
+
+Mapping to IPCEI-CIS deliverables and project milestones.
+
+## Compliance & Audit
+
+### Technology Choices
+
+Documentation of technology evaluation and selection process for key components (e.g., VictoriaMetrics, GARM, Terraform, ArgoCD).
+
+### Security Controls
+
+Overview of implemented security controls and compliance measures.
+
+### Ticket References
+
+Cross-references to Jira tickets, epics, and project tracking for audit trails.
+
+## Community & External Relations
+
+### Open Source Contributions
+
+Contributions to the Forgejo community and other open-source projects.
+
+### External Stakeholders
+
+User experience research and feedback integration.
+
+## Documentation Template
+
+When creating governance documentation:
+
+1. **Context**: Background and situation
+2. **Decision/Event**: What was decided or what happened
+3. **Rationale**: Why this decision was made
+4. **Alternatives**: Other options considered
+5. **Consequences**: Impact and outcomes
+6. **References**: Links to tickets, discussions, external resources
diff --git a/content/en/docs/operations/_index.md b/content/en/docs/operations/_index.md
new file mode 100644
index 0000000..db0db71
--- /dev/null
+++ b/content/en/docs/operations/_index.md
@@ -0,0 +1,60 @@
+---
+title: "Operations"
+linkTitle: "Operations"
+weight: 4
+description: >
+ Operational guides for deploying, monitoring, and maintaining the Edge Developer Platform.
+---
+
+## Operations Overview
+
+This section covers operational aspects of the Edge Developer Platform including deployment, monitoring, troubleshooting, and maintenance.
+
+## Deployment
+
+### Platform Deployment
+
+Instructions for deploying EDP components to your infrastructure.
+
+### Application Deployment
+
+Guides for deploying applications to the platform using available deployment methods.
+
+## Monitoring & Observability
+
+### Metrics
+
+Access and interpret platform and application metrics using VictoriaMetrics, Prometheus, and Grafana.
+
+### Logging
+
+Log aggregation and analysis for troubleshooting and audit purposes.
+
+### Alerting
+
+Configure alerts for critical platform events and application issues.
+
+## Troubleshooting
+
+Common issues and their solutions for platform operations.
+
+## Maintenance
+
+### Updates & Upgrades
+
+Procedures for updating platform components and maintaining system health.
+
+### Backup & Recovery
+
+Data backup strategies and disaster recovery procedures.
+
+## Documentation Template
+
+When creating operational documentation:
+
+1. **Purpose**: What this operation achieves
+2. **Prerequisites**: Required access, tools, and knowledge
+3. **Procedure**: Step-by-step instructions with commands
+4. **Verification**: How to confirm successful completion
+5. **Rollback**: How to revert if needed
+6. **Troubleshooting**: Common issues and solutions
diff --git a/content/en/docs/platform-overview/_index.md b/content/en/docs/platform-overview/_index.md
new file mode 100644
index 0000000..f116f64
--- /dev/null
+++ b/content/en/docs/platform-overview/_index.md
@@ -0,0 +1,48 @@
+---
+title: "Platform Overview"
+linkTitle: "Platform Overview"
+weight: 1
+description: >
+ High-level overview of the Edge Developer Platform (EDP), its purpose, and product structure.
+---
+
+## Purpose
+
+The Edge Developer Platform (EDP) is a comprehensive DevOps platform designed to enable developers to build, deploy, and operate cloud-native applications at the edge. It provides an integrated suite of tools and services covering the entire software development lifecycle.
+
+## Target Audience
+
+* **Developers**: Build and deploy applications using standardized workflows
+* **Platform Engineers**: Operate and maintain the platform infrastructure
+* **DevOps Teams**: Implement CI/CD pipelines and automation
+* **Auditors**: Verify platform capabilities and compliance
+
+## Product Structure
+
+EDP consists of multiple integrated components organized in layers:
+
+### Core Platform Services
+
+The foundation layer provides essential platform capabilities including source code management, CI/CD, and container orchestration.
+
+### Developer Experience
+
+Tools and services that developers interact with directly to build, test, and deploy applications.
+
+### Infrastructure & Operations
+
+Infrastructure automation, observability, and operational tooling for platform management.
+
+## Platform Maturity
+
+Components in EDP have different maturity levels:
+
+* **Production**: Fully integrated and supported for production use
+* **Beta**: Available for testing with potential changes
+* **Experimental**: Early stage, subject to significant changes
+
+## Getting Started
+
+For quick start guides and onboarding information, see the [Getting Started](../getting-started/) section.
+
+For detailed component information, explore the [Components](../components/) section.
diff --git a/README-developer.md b/doc/README-developer.md
similarity index 100%
rename from README-developer.md
rename to doc/README-developer.md
diff --git a/README-likec4.md b/doc/README-likec4.md
similarity index 100%
rename from README-likec4.md
rename to doc/README-likec4.md
diff --git a/README-technical-writer.md b/doc/README-technical-writer.md
similarity index 100%
rename from README-technical-writer.md
rename to doc/README-technical-writer.md
diff --git a/RELEASE.md b/doc/RELEASE.md
similarity index 100%
rename from RELEASE.md
rename to doc/RELEASE.md
diff --git a/TODO.md b/doc/TODO.md
similarity index 100%
rename from TODO.md
rename to doc/TODO.md