Links

docs/getting-started-multi-cluster.md

@@ -37,4 +37,4 @@ To ensure that any DNS records are removed, you should remove any `DNSPolicy` an
 
 The next step is to setup and use the policies provided by Kuadrant. 
 
-[Secure, Protect and Connect your Gateway](kuadrant-operator/doc/user-guides/secure-protect-connect.md)
+[Secure, Protect and Connect your Gateway](kuadrant-operator/doc/user-guides/full-walkthrough/secure-protect-connect-k8s.md)

docs/getting-started-single-cluster.md

@@ -72,6 +72,6 @@ To ensure that any DNS records are removed, you should remove any `DNSPolicy` an
 
 The next step is to setup and use the policies provided by Kuadrant. 
 
-[Secure, Protect and Connect your Gateway](kuadrant-operator/doc/user-guides/secure-protect-connect.md)
+[Secure, Protect and Connect your Gateway](kuadrant-operator/doc/user-guides/full-walkthrough/secure-protect-connect-k8s.md)
 
 

docs/index.md

@@ -1,6 +1,6 @@
 # Overview
 
-Kuadrant combines [Gateway API](https://gateway-api.sigs.k8s.io/) and [Istio](https://istio.io/latest/docs/tasks/traffic-management/ingress/gateway-api/)-based gateway controllers to enhance application connectivity. It enables platform engineers and application developers to easily connect, secure, and protect their services and infrastructure across multiple clusters with policies for [TLS](kuadrant-operator/doc/tls.md), [DNS](kuadrant-operator/doc/reference/dnspolicy.md), application [authentication & authorization](kuadrant-operator/doc/auth.md), and [rate limiting](kuadrant-operator/doc/rate-limiting.md). Additionally, Kuadrant offers [observability templates](kuadrant-operator/doc/observability/examples.md) to further support infrastructure management.
+Kuadrant combines [Gateway API](https://gateway-api.sigs.k8s.io/) and [Istio](https://istio.io/latest/docs/tasks/traffic-management/ingress/gateway-api/)-based gateway controllers to enhance application connectivity. It enables platform engineers and application developers to easily connect, secure, and protect their services and infrastructure across multiple clusters with policies for [TLS](kuadrant-operator/doc/overviews/tls.md), [DNS](kuadrant-operator/doc/reference/dnspolicy.md), application [authentication & authorization](kuadrant-operator/doc/overviews/auth.md), and [rate limiting](kuadrant-operator/doc/overviews/rate-limiting.md). Additionally, Kuadrant offers [observability templates](kuadrant-operator/doc/observability/examples.md) to further support infrastructure management.
 
 <iframe width="100%" height="400" src="https://www.youtube.com/embed/euWAMvQojP4" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
 

mkdocs.yml

@@ -123,32 +123,32 @@ nav:
       - 'OpenShift': kuadrant-operator/doc/install/install-openshift.md
   - 'Concepts and APIs':
       - 'DNSPolicy':
-          - 'Overview': kuadrant-operator/doc/dns.md
+          - 'Overview': kuadrant-operator/doc/overviews/dns.md
           - 'Reference': kuadrant-operator/doc/reference/dnspolicy.md
-          - 'Gateway DNS for Cluster Operators': kuadrant-operator/doc/user-guides/gateway-dns.md
+          - 'Gateway DNS for ingress Gateway': kuadrant-operator/doc/user-guides/dns/gateway-dns.md
           - 'Configuring DNS Providers': dns-operator/docs/provider.md
       - 'TLSPolicy':
-          - 'Overview': kuadrant-operator/doc/tls.md
+          - 'Overview': kuadrant-operator/doc/overviews/tls.md
           - 'Reference': kuadrant-operator/doc/reference/tlspolicy.md
       - 'AuthPolicy':
-          - 'Overview': kuadrant-operator/doc/auth.md
+          - 'Overview': kuadrant-operator/doc/overviews/auth.md
           - 'Reference': kuadrant-operator/doc/reference/authpolicy.md
       - 'RateLimitPolicy':
-          - 'Overview': kuadrant-operator/doc/rate-limiting.md
+          - 'Overview': kuadrant-operator/doc/overviews/rate-limiting.md
           - 'Reference': kuadrant-operator/doc/reference/ratelimitpolicy.md
   - 'How-to Guides':
-      - 'Secure, connect and protect - Kubernetes': kuadrant-operator/doc/user-guides/secure-protect-connect.md
-      - 'Secure, connect and protect - OpenShift': kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster.md
+      - 'Secure, connect and protect - Kubernetes': kuadrant-operator/doc/user-guides/full-walkthrough/secure-protect-connect-k8s.md
+      - 'Secure, connect and protect - OpenShift': kuadrant-operator/doc/user-guides/full-walkthrough/secure-protect-connect-openshift.md
       - 'DNS configuration':
           - 'DNS Providers': dns-operator/docs/provider.md
       - 'TLS configuration':
-          - 'Gateway TLS for Cluster Operators': kuadrant-operator/doc/user-guides/gateway-tls.md
+          - 'Gateway TLS for Cluster Operators': kuadrant-operator/doc/user-guides/tls/gateway-tls.md
       - 'Authentication & Authorization':
-          - 'AuthPolicy for Application Developers and Platform Engineers': kuadrant-operator/doc/user-guides/auth-for-app-devs-and-platform-engineers.md
+          - 'AuthPolicy for Application Developers and Platform Engineers': kuadrant-operator/doc/user-guides/auth/auth-for-app-devs-and-platform-engineers.md
       - 'Rate Limiting':
-          - 'RateLimitPolicy for Platform Engineers': kuadrant-operator/doc/user-guides/gateway-rl-for-cluster-operators.md
-          - 'Authenticated Rate Limiting for Application Developers': kuadrant-operator/doc/user-guides/authenticated-rl-for-app-developers.md
-          - kuadrant-operator/doc/user-guides/authenticated-rl-with-jwt-and-k8s-authnz.md
+          - 'RateLimitPolicy for Platform Engineers': kuadrant-operator/doc/user-guides/ratelimiting/gateway-rl-for-cluster-operators.md
+          - 'Authenticated Rate Limiting for Application Developers': kuadrant-operator/doc/user-guides/ratelimiting/authenticated-rl-for-app-developers.md
+          - kuadrant-operator/doc/user-guides/ratelimiting/authenticated-rl-with-jwt-and-k8s-authnz.md
       - 'Observability':
           - 'Metrics': kuadrant-operator/doc/observability/metrics.md
           - 'Dashboards and Alerts': kuadrant-operator/doc/observability/examples.md
@@ -172,8 +172,8 @@ nav:
   - 'Components':
       - 'Kuadrant Operator':
           - 'Overview': kuadrant-operator/README.md
-          - "Developer's Guide": kuadrant-operator/doc/development.md
-          - kuadrant-operator/doc/logging.md
+          - "Developer's Guide": kuadrant-operator/doc/overviews/development.md
+          - kuadrant-operator/doc/overviews/logging.md
       - 'Authorino':
           - 'Overview': authorino/README.md
           - 'Authorino Operator': authorino-operator/README.md
@@ -235,4 +235,4 @@ nav:
           - 'Generating Kuadrant RateLimitPolicies': kuadrantctl/doc/generate-kuadrant-rate-limit-policy.md
           - 'CI/CD with kuadrantctl & Tekton': kuadrantctl/doc/kuadrantctl-ci-cd.md
           - 'Using Apicurio Studio with Kuadrant OAS extensions': kuadrantctl/doc/openapi-apicurio.md
-          - 'Using OpenShift Dev Spaces with Kuadrant OAS extensions': kuadrantctl/doc/openapi-openshift-dev-spaces.md
+          - 'Using OpenShift Dev Spaces with Kuadrant OAS extensions': kuadrantctl/doc/openapi-openshift-dev-spaces.md