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,60 +1,53 @@
 # FAQ
 
-## 
+## Allgemeine Design Decisions
 
-## Serveradmin FAQ
+???+ faq "Warum Opensource?"
+    * kein Vendor-Lockin
+    * Weltweite Softwareentwicklung
+    * Nachweisbare software qualität
+    * Individualisierbar
+    * Sicherer (mehr Augen)
+    * Community
+    * Public Money, Public Code
+    * Use, Study, Share, Improve 
 
-* 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)
+??? faq "Warum selbst hosten?"
+    * Datenhohheit
+    * Souveränität
 
+??? faq " Warum openid-connect?"
+    * moderner Offener Standard
+    * flexible anbindung von apps
+      sso session nicht auf eine domäne begrenzt
   
+??? faq "Warum Containerisieren?"
+    * unterschiedliche Apps, unterschiedliche Bedürfnisse
+    * Isolation (Security)
+    * Update einfacher
+    * trennung von image - volumes
+    * besser skalieren 
 
-## WiP
+??? faq " Container vs VM"
+    * weniger ressourcen, schneller
+      (container enhält nur das was benötigt wird, gleiche images sparen speicher)
+    * leichter zu orchestrieren
 
-Warum Opensource?
-* kein Vendor-Lockin
-* Weltweite Softwareentwicklung
-* Nachweisbare software qualität
-* Individualisierbar
-* Sicherer (mehr Augen)
-* Community
-* Public Money, Public Code
-* Use, Study, Share, Improve 
+??? faq "Warum so viele einzelne DBs?"
+    * Unterschiedliche bedarfe Postgres/Mysql/Mongo
+    * in unterschiedlichen Versionen
+    * leicht zu orchestrieren
   
-Warum selbst hosten?
-* Datenhohheit
-* Souveränität
+??? faq "Warum nicht Kubernetes?"
+    * Zu komplex
+    * single node systeme für unsere zielgruppe
 
-Warum openid-connect?
-* moderner Offener Standard
-* flexible anbindung von apps
-  sso session nicht auf eine domäne begrenzt
-  Google Session authentifiziert
+## Server Operator
 
-Warum Containerisieren? (vs one system)
-* unterschiedliche Apps, unterschiedliche Bedürfnisse
-* Isolation (Security)
-* Update einfacher
-* trennung von image - volumes
-* besser skalieren 
+### Authentik 
 
-Container vs VM
-* weniger ressourcen, schneller
-  (container enhält nur das was benötigt wird, gleiche images sparen speicher)
-* leichter zu orchestrieren
+??? 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)
 
-Warum so viele einzelne DBs?
-* Unterschiedliche bedarfe Postgres/Mysql/Mongo
-* in unterschiedlichen Versionen
-* leicht zu migrieren
-
-Warum nicht Kubernetes?
-* Zu komplex
-* single node systeme für unsere zielgruppe
-
-Aber sind container nicht unsicher?
-* nicht wenn man weiß was man tut 
-* privilieged container mit vorsicht genießen
-* gut prüfen wo die images herkommen (selber bauen)
-* apparmor, ressourcen limits
+    * 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/