diff --git a/likec4/README.md b/likec4/README.md
index 34ea5e1..cc88733 100644
--- a/likec4/README.md
+++ b/likec4/README.md
@@ -21,4 +21,9 @@ npx playwright install
 npm install likec4
 
 // render
-node@e20899c8046f:/app/content/en/docs/project/onboarding$ ./node_modules/.bin/likec4 export png -o ./images .
\ No newline at end of file
+node@e20899c8046f:/app/content/en/docs/project/onboarding$ ./node_modules/.bin/likec4 export png -o ./images .
+
+## trouble shooting
+
+when refactoring you might need to restart the languange server, just that it updates its internal model representation
+In VSCode it is: `ctrl+Shift+P' + 'LikeC4: restart languange server`
\ No newline at end of file
diff --git a/likec4/models/deployment/deployment.c4 b/likec4/deployment/deployment.c4
similarity index 90%
rename from likec4/models/deployment/deployment.c4
rename to likec4/deployment/deployment.c4
index 67f65f8..a4417b8 100644
--- a/likec4/models/deployment/deployment.c4
+++ b/likec4/deployment/deployment.c4
@@ -83,19 +83,3 @@ deployment {
   }
 }
 
-views {
-  deployment view index {
-    title 'Local Deployment'
-
-    include
-      *,
-      local.**,
-      monitoring.*,
-      openbao.*,
-      externalSecrets.*,
-      crossplane.*,
-      spark.*,
-      argocd.*
-	}
-}
-
diff --git a/likec4/models/context/edfoundry.c4 b/likec4/models/context/edfoundry.c4
index fdc777b..2453ca1 100644
--- a/likec4/models/context/edfoundry.c4
+++ b/likec4/models/context/edfoundry.c4
@@ -1,9 +1,10 @@
 model {
   edf = system 'EDF' {
-    description 'EDP Foundry, the EDP builder'
+    description 'EDP Foundry is a platform for building and deploying EDPs tenantwise.'
     technology 'Kubernetes'
     icon tech:kubernetes
     -> edp 'builds many'
     platformdeveloper -> edf "develops EDP and EDF"
+
   }
 }
\ No newline at end of file
diff --git a/likec4/views/deployment/deployment.c4 b/likec4/views/deployment/deployment.c4
new file mode 100644
index 0000000..9090e60
--- /dev/null
+++ b/likec4/views/deployment/deployment.c4
@@ -0,0 +1,16 @@
+views {
+  deployment view index {
+    title 'Local Deployment'
+
+    include
+      *,
+      local.**,
+      local.monitoring.*,
+      local.openbao.*,
+      local.externalSecrets.*,
+      local.crossplane.*,
+      local.spark.*,
+      local.argocd.*
+	}
+}
+
diff --git a/likec4/views/cicd/gitops-inner-outer-loop.c4 b/likec4/views/dynamic/cicd/gitops-inner-outer-loop.c4
similarity index 100%
rename from likec4/views/cicd/gitops-inner-outer-loop.c4
rename to likec4/views/dynamic/cicd/gitops-inner-outer-loop.c4
diff --git a/likec4/views/concept/application-transition.c4 b/likec4/views/high-level-concept/application-transition.c4
similarity index 100%
rename from likec4/views/concept/application-transition.c4
rename to likec4/views/high-level-concept/application-transition.c4
diff --git a/likec4/views/platform-context/developer-landscape-with-foundry.c4 b/likec4/views/high-level-concept/platform-context/developer-landscape-with-foundry.c4
similarity index 100%
rename from likec4/views/platform-context/developer-landscape-with-foundry.c4
rename to likec4/views/high-level-concept/platform-context/developer-landscape-with-foundry.c4
diff --git a/likec4/views/platform-context/developer-landscape.c4 b/likec4/views/high-level-concept/platform-context/developer-landscape.c4
similarity index 100%
rename from likec4/views/platform-context/developer-landscape.c4
rename to likec4/views/high-level-concept/platform-context/developer-landscape.c4