doc(technical-documentation): initial port of technical documentation

docs/introduction/technical-documentation.md

@@ -0,0 +1,7 @@
+# Technical Documentation
+
+## Outline
+
+1. Concepts
+  The underlying platforming concepts of the Edge Developer Framework (EDF) solution, i.e. the problem domain
+

docs/introduction/user-documentation.md

@@ -0,0 +1,32 @@
+# User Documentation
+
+## 📋 Outline
+- [What is it? (short description what the software does, max 3 sentences)](#what-is-it)
+  - A couple of use cases (different scopes)
+  - Why do I need / want this? When should I pass?
+  - Compare with other platforms
+  - Compare with well-known tools (what parts of my stack / pipeline does this cover?)
+    - argo -> vercel
+    - monitoring -> data dog
+    - forgejo -> graphite
+- [Main features (brief list of main features and enablers - why it is in the stack)](#main-features)
+  - what are our opinions / core principles and believes that are backed in?
+    - k8s > *
+  - Developer Portal: Backstage
+- [Quick start guide](#quick-start-guide)
+- [Configuration](#configuration)
+  - structure of the poc (where / how can I change something?)
+  - how does it work? (bootstrapping++)
+- [Known Issues / TODOs](#known-issues)
+- [References (documentation links etc...)](#references)
+
+## 🧐 What is it?
+
+## 📦 Main features
+
+## ⏱️ Quick start guide
+
+## ⚙️ Configuration
+
+## 🔗 References
+- Technical Documentation  

docs/technical-documentation/concepts/1_software-and-workloads/_index.md

@@ -6,3 +6,4 @@ description: 'The center of everything else, the reason, driver and center of al
 ---
 
 
+> The center of everything else, the reason, driver and center of all being: Running Code

docs/technical-documentation/concepts/5_platforms/CNOE/_index.md

@@ -1,7 +1,7 @@
-+++
+---
-title = "CNOE"
+title: CNOE
-weight = 4
+weight: 4
-+++
+---
 
 
 * https://cnoe.io/docs/intro

docs/technical-documentation/concepts/5_platforms/Humanitec/_index.md

@@ -1,7 +1,7 @@
-+++
+---
-title = "Humanitec"
+title: Humanitec
-weight = 4
+weight: 4
-+++
+---
 
 
 tbd

docs/technical-documentation/concepts/5_platforms/_index.md

@@ -6,3 +6,7 @@ description: Platform automation is the next level of platforming
 ---
 
 
+* [CNOE](./CNOE/_index.md)
+* [Humanitec](./Humanitec/_index.md)
+* [Kratix](./Kratix/_index.md)
+* [BACKstack]()

mkdocs.yaml

@@ -3,9 +3,10 @@ site_description: 'EDP documentation'
 
 nav:
   - Home: index.md
-  - Overview: 
+  - Introduction: 
-    - User Documentation: gettingstarted/user-documentation.md
+    - User Documentation: introduction/user-documentation.md
-  - User Guide: 
+    - Technical Documentation: introduction/technical-documentation.md
+  - User Documentation: 
     - ArgoCD: userguide/argocd.md
     - Backstage: userguide/backstage.md
     - CI Workflow: userguide/ci-workflow.md
@@ -17,15 +18,15 @@ nav:
     - OpenBAO: userguide/openbao.md
     - PetClinic: userguide/petclinic.md
   - Technical Documentation:
-    - Platfrom concepts: technical-documentation/concepts/_index.md
+    - Platform concepts: 
-    - Deployment: techdocs/deployment.md
+      - 'Code: Software and Workloads': technical-documentation/concepts/1_software-and-workloads/_index.md 
-    - Development: techdocs/development.md
+      - Engineers: technical-documentation/concepts/2_engineering-people/_index.md 
-    - Testing: techdocs/testing.md
+      - Use Cases: technical-documentation/concepts/3_use-cases/_index.md 
+      - Digital Platforms: technical-documentation/concepts/4_digital-platforms/_index.md 
+      - Platform Orchestrators: technical-documentation/concepts/5_platforms/_index.md
   - About: 
     - License: about/license.md
     - Release Notes: about/release-notes.md
-    - A Test doc: about/mkdocs-test.md
-
 
 plugins:
   - techdocs-core