general styling + keycloak.md

README.md

@@ -41,6 +41,10 @@ Our documentation is designed to be easily accessible regardless of your environ
 1. **in Our Open Sovereign Cloud**  
 Our documentation can be easily accessed through a Backstage instance hosted on our Open Sovereign Cloud (OSC). Simply log in to our OSC Backstage platform to read through the documentation.
 
+- URL: https://edf-cc1.cx.fg1.ffm.osc.live
+- Username: user1
+- Password: PpMpfZYICG9MRRF-3QBY2Zz1-+URYB6+-JRe
+
 2. **in a local kind Cluster**  
     Using the edpbuilder, you can set up a local IDP that comes with a Backstage instance containing the documentation.
     *[How to set up a local IDP on a kind cluster](docs/userguide/edpbuilder.md)*

docs/userguide/argocd.md

@@ -1,8 +1,9 @@
-## ArgoCD
+# ArgoCD
 
 [Argo CD](https://argoproj.github.io/cd/) is an open-source **continuous delivery platform** that automates the deployment of applications to Kubernetes clusters. It ensures consistent deployments by minimizing human errors and increasing efficiency through **declarative** configuration management, using **Git repositories as the single source of truth** for defining application infrastructure states.
 
-## Main Features
+## Main features
+
 **1. Declarative Configuration Management**
 Argo CD uses declarative YAML or JSON files stored in Git repositories to manage application infrastructure. These files define the desired state, ensuring that applications are consistently deployed to Kubernetes clusters with every deployment.
 
@@ -12,5 +13,6 @@ Designed specifically for Kubernetes, Argo CD integrates seamlessly within the K
 **3. Self-Healing and Automatic Rollbacks**
 Argo CD detects drift (when the actual state of a cluster deviates from the desired state) and automatically reconciles changes to restore the desired state. It also supports automatic rollbacks in the event of deployment failures, provided policies are defined in Git configurations.
 
-## References
+## 🔗 References
+
 https://argo-cd.readthedocs.io/en/stable/

docs/userguide/forgejo.md

@@ -41,6 +41,7 @@ Forgejo Runner ensures that your CI/CD processes run smoothly and consistently.
 ---
 
 ## 🔗 References
-* [Forgejo Documentation & Community](https://forgejo.org/)
-* [Forgejo Runner Guildes & Documentation](https://forgejo.org/docs/latest/admin/runner-installation/)
-* [Forgejo Runner's Repository](https://code.forgejo.org/forgejo/runner)
+
+- [Forgejo Documentation & Community](https://forgejo.org/)
+- [Forgejo Runner Guildes & Documentation](https://forgejo.org/docs/latest/admin/runner-installation/)
+- [Forgejo Runner's Repository](https://code.forgejo.org/forgejo/runner)

docs/userguide/grafana.md

@@ -7,14 +7,17 @@ Various telemetry tools are included in the technology stack of this repository.
 Kube-prometheus-stack contains Kubernetes manifests, Prometheus and Grafana, including preconfigured dashboards.
 
 ### Kube-prometheus-stack Overview
+
 Grafana is an open-source monitoring solution that enables viusalization of metrics and logs.
 Prometheus is an open-source monitoring and alerting system which collects metrics from services and allows the metrics to be shown in Grafana.
 
 ### Start
+
 Once Grafana is running it is accessible under https://cnoe.localtest.me/grafana.
 Many preconfigured dashboards can be used by klicking the menu option Dashboards.
 
 ### Adding your own dashboards
+
 The application edfbuilder/kind/stacks/core/kube-prometheus.yaml is used to import new Loki dashboards.
 Examples for imported dashboards can be found in the folder edfbuilder/kind/stacks/core/kube-prometheus/dashboards.
 
@@ -30,6 +33,7 @@ Currently preconfigured dashboards include several dahboards for Loki and a dash
 Grafana Loki is a scalable open-source log aggregation system
 
 ### Loki Overview
+
 The application Grafana Loki is started in edfbuilder/kind/stacks/core/loki.yaml. 
 Loki is started in microservices mode and contains the components ingester, distributor, querier, and query-frontend.
 The Helm values file edfbuilder/kind/stacks/core/loki/values.yaml contains configuration values.

docs/userguide/keycloak.md

@@ -1 +1,18 @@
-robert
+# Keycloak
+
+Keycloak is an open-source Identity and Access Management (IAM) solution that simplifies handling user authentication, authorization, and identity federation. By centralizing these processes, it helps maintain a secure environment without forcing you to reinvent the wheel. Whether you’re dealing with standard login flows, integrating social logins (e.g. Google, GitHub), or managing roles across large teams, Keycloak provides a flexible and scalable foundation.
+
+---
+
+## Key Features
+
+    Single Sign-On (SSO): Enable users to access multiple applications and services with a single set of credentials, reducing login fatigue and improving the user experience.
+    User Federation: Integrate your existing user stores—such as LDAP, Active Directory, or custom databases—without re-engineering your authentication layer.
+    Role-Based Access Control (RBAC): Assign fine-grained roles and permissions to users or groups, making it easier to manage security policies at scale.
+    Social Login & Identity Brokering: Offer seamless authentication through providers like Google, Facebook, or GitHub, saving time by not building these integrations yourself.
+    Extensible & Customizable: Adjust Keycloak’s behavior using custom providers, themes, or authentication flows that match your project’s unique requirements.
+
+## 🔗 References
+
+- Official Documentation: Keycloak Docs
+- GitHub Repository: Keycloak on GitHub