update

.gitmodules

@@ -1,3 +1,5 @@
 [submodule "docs/tools"]
 	path = docs/tools
 	url = https://git.local-it.org/local-it/tools
+[submodule "docs"]
+	url = ssh://git@git.local-it.org:2222/local-it/tools.git

docs/faq.md

@@ -1,18 +1,8 @@
 # FAQ
 
-## 
+## Allgemeine Design Decisions
 
-## Serveradmin FAQ
+???+ faq "Warum Opensource?"
-
-* I accidientially removed myself from the admin group in Authentik and lost access  
-  `abra app run swe-hospiz-sso server ak create_admin_group admin`   
-  [see docs](https://goauthentik.io/docs/troubleshooting/missing_admin_group)
-
-
-
-## WiP
-
-Warum Opensource?
     * kein Vendor-Lockin
     * Weltweite Softwareentwicklung
     * Nachweisbare software qualität
@@ -22,39 +12,42 @@ Warum Opensource?
     * Public Money, Public Code
     * Use, Study, Share, Improve 
 
-Warum selbst hosten?
+??? faq "Warum selbst hosten?"
     * Datenhohheit
     * Souveränität
 
-Warum openid-connect?
+??? faq " Warum openid-connect?"
     * moderner Offener Standard
     * flexible anbindung von apps
       sso session nicht auf eine domäne begrenzt
-  Google Session authentifiziert
   
-Warum Containerisieren? (vs one system)
+??? faq "Warum Containerisieren?"
     * unterschiedliche Apps, unterschiedliche Bedürfnisse
     * Isolation (Security)
     * Update einfacher
     * trennung von image - volumes
     * besser skalieren 
 
-Container vs VM
+??? faq " Container vs VM"
     * weniger ressourcen, schneller
       (container enhält nur das was benötigt wird, gleiche images sparen speicher)
     * leichter zu orchestrieren
 
-Warum so viele einzelne DBs?
+??? faq "Warum so viele einzelne DBs?"
     * Unterschiedliche bedarfe Postgres/Mysql/Mongo
     * in unterschiedlichen Versionen
-* leicht zu migrieren
+    * leicht zu orchestrieren
   
-Warum nicht Kubernetes?
+??? faq "Warum nicht Kubernetes?"
     * Zu komplex
     * single node systeme für unsere zielgruppe
 
-Aber sind container nicht unsicher?
+## Server Operator
-* nicht wenn man weiß was man tut 
+
-* privilieged container mit vorsicht genießen
+### Authentik 
-* gut prüfen wo die images herkommen (selber bauen)
+
-* apparmor, ressourcen limits
+??? failure "Ich habe ausversehen meinen Admin Account von der Admin Gruppe entfernt"
+    `abra app run sso.example.org server ak create_admin_group admin`   
+    [see docs](https://goauthentik.io/docs/troubleshooting/missing_admin_group)
+
+    * hohe ressourcen verbrauch

docs/index.md

@@ -20,6 +20,9 @@ Apps:
 * [OnlyOffice](installation/onlyoffice.md)
 * [Wekan](installation/wekan.md)
 
+
+[Frequently Asked Questions](./faq.md)
+
 ---
 
 Ein Projekt von [local-it](https://local-it.org)

docs/tools

@@ -1 +1 @@
-Subproject commit 0e3c125c8819d042b3321bbe8cbba7ef938b82ad
+Subproject commit d1af96a832b22f4c61226442a1775fa54799af13

mkdocs.yml

@@ -18,6 +18,7 @@ markdown_extensions:
   - pymdownx.details
   - pymdownx.superfences
 
+
 repo_name: LIT/docs
 repo_url: https://git.local-it.org/local-it/docs
 edit_uri: _edit/main/docs/