docs(installation): fix overview items (#3880)

* docs(installation): fix overview items

* installation after getting started

* fix broken links

* fix broken links

* fix broken link

docs/docs/guides/installation/configure/configure.mdx

@@ -11,7 +11,7 @@ import Helm from './helm.mdx'
 
 # Configure ZITADEL
 
-This guide assumes you are already familiar with [running ZITADEL with the most minimal configuration possible](./get-started).
+This guide assumes you are already familiar with [running ZITADEL with the most minimal configuration possible](./run).
 
 ## Configuration Files
 

docs/docs/guides/installation/configure/helm.mdx

@@ -1,7 +1,7 @@
 By default, the chart installs a secure ZITADEL and CockroachDB.
 The example files makes an insecure ZITADEL accessible by port forwarding the ZITADEL service to localhost.
 For more configuration options, [go to the chart repo descriptions](https://github.com/zitadel/zitadel-charts).
-For a secure installation with Docker Compose, [go to the loadbalancing example](../loadbalancing-example/loadbalancing-example)
+For a secure installation with Docker Compose, [go to the loadbalancing example](/docs/guides/installation/loadbalancing-example)
 
 By executing the commands below, you will download the following files:
 - [example-zitadel-values.yaml](./example-zitadel-values.yaml)

docs/docs/guides/installation/run/nextselfhosted.mdx

@@ -5,9 +5,9 @@ This is the default IAM admin users login:
 
 ## What's next
 
-For running a production grade ZITADEL instance in your environment, go on with the [configure ZITADEL](./configure) section.
+For running a production grade ZITADEL instance in your environment, go on with the [configure ZITADEL](/docs/guides/installation/configure) section.
 
 :::caution
 
 <!-- TODO: Better mark the link in the UI -->
-The ZITADEL management console [requires end-to-end HTTP/2 support](./http2-support)
+The ZITADEL management console [requires end-to-end HTTP/2 support](/docs/guides/installation/http2-support)

docs/docs/guides/installation/run/run.mdx

@@ -1,5 +1,5 @@
 ---
-title: Get Started
+title: Run
 ---
 
 import Tabs from "@theme/Tabs";

docs/docs/guides/overview.mdx

@@ -7,7 +7,7 @@ import Column from "../../src/components/column";
 
 With our guides you will learn everything you need to know about specific topics. You get step-by-step instructions for certain tasks and have a knowledge check at the end.
 
-You can either use our cloud-instance [zitadel.com](https://zitadel.com) or deploy your own **ZITADEL** instance. To get started, we recommend you to try out our free tier first. Jump directly to the [get started](./installation) docs.
+You can either use our cloud-instance [zitadel.com](https://zitadel.com) or deploy your own **ZITADEL** instance. To get started, we recommend you to try out our free tier first. Jump directly to the [get started](./basics/get-started) docs.
 
 <Column>
   <ListWrapper title="Get to know ZITADEL">
@@ -30,6 +30,26 @@ You can either use our cloud-instance [zitadel.com](https://zitadel.com) or depl
       description="Understand projects and grants"
     />
   </ListWrapper>
+  <ListWrapper title="Installation">
+    <ListElement
+      link="/docs/guides/installation/run"
+      type={ICONTYPE.SYSTEM}
+      title="Run ZITADEL"
+      description="Learn how to run ZITADEL on your preferred platform"
+    />
+    <ListElement
+      link="/docs/guides/installation/configure"
+      type={ICONTYPE.SYSTEM}
+      title="Configure ZITADEL"
+      description="Learn how to configure your ZITADEL installation"
+    />
+    <ListElement
+      link="/docs/guides/installation/loadbalancing-example"
+      type={ICONTYPE.SYSTEM}
+      title="Near Production Example"
+      description="Try an example with a correctly configured load balancer"
+    />
+  </ListWrapper>
   <ListWrapper title="Integrations">
     <ListElement
       link="./integrations/authenticated-mongodb-charts"
@@ -99,12 +119,4 @@ You can either use our cloud-instance [zitadel.com](https://zitadel.com) or depl
       description=""
     />
   </ListWrapper>
-  <ListWrapper title="Installation">
-    <ListElement
-      link="/docs/guides/installation"
-      type={ICONTYPE.SYSTEM}
-      title="Managed"
-      description="Learn to install ZITADEL"
-    />
-  </ListWrapper>
 </Column>

docs/docs/legal/data-processing-agreement.mdx

@@ -33,7 +33,7 @@ The Processor is responsible for taking appropriate technical and organizational
 
 ### Bound by directions
 
-The Processor processes personal data in accordance with its privacy policy (cf. [Privacy Policy](privacy-policy.md)) and on the documented directions of the Customer. The initial direction result from the Agreement. Subsequent instructions shall be given either in writing, whereby e-mail shall suffice, or orally with immediate written confirmation.
+The Processor processes personal data in accordance with its privacy policy (cf. [Privacy Policy](/docs/legal/privacy-policy)) and on the documented directions of the Customer. The initial direction result from the Agreement. Subsequent instructions shall be given either in writing, whereby e-mail shall suffice, or orally with immediate written confirmation.
 
 If the Processor is of the opinion that a direction of the Customer violates the Agreement, the GDPR or other data protection provisions of the EU, EU Member States or Switzerland, it shall inform the Customer thereof and shall be entitled to suspend the Processing until the instruction is withdrawn or confirmed.
 

docs/docs/legal/terms-support-service.md

@@ -146,7 +146,7 @@ Recertification of a unit, to be covered under Support Services, is required for
 * units that run a release that is older than 180 days from the products most recent stable release
 * requests for support on products and services purchased or supported from non-authorized resellers
 
-Recertification of a unit requires payment of a Recertification Fee which results in a [checkup](/docs/guides/installation/checkup) of the unit by CAOS. The unit will be inspected to asses its condition and eligibility for service coverage.
+Recertification of a unit requires payment of a Recertification Fee which results in a checkup of the unit by CAOS. The unit will be inspected to asses its condition and eligibility for service coverage.
 
 Please contact us for current fees.
 

docs/docusaurus.config.js

@@ -4,7 +4,7 @@ module.exports = {
   trailingSlash: false,
   url: "https://docs.zitadel.com",
   baseUrl: "/",
-  onBrokenLinks: "warn",
+  onBrokenLinks: "throw",
   onBrokenMarkdownLinks: "warn",
   favicon: "img/favicon.ico",
   organizationName: "zitadel",

docs/sidebars.js

@@ -36,18 +36,6 @@ module.exports = {
   ],
   guides: [
     "guides/overview",
-    {
-      type: "category",
-      label: "Install ZITADEL",
-      collapsed: false,
-      items: [
-        "guides/installation/get-started/get-started",
-        "guides/installation/configure/configure",
-        "guides/installation/custom-domain",
-        "guides/installation/http2-support",
-        "guides/installation/loadbalancing-example/loadbalancing-example",
-      ],
-    },
     {
       type: "category",
       label: "Get to know ZITADEL",
@@ -60,6 +48,18 @@ module.exports = {
         "guides/basics/applications",
       ],
     },
+    {
+      type: "category",
+      label: "Install ZITADEL",
+      collapsed: false,
+      items: [
+        "guides/installation/run/run",
+        "guides/installation/configure/configure",
+        "guides/installation/custom-domain",
+        "guides/installation/http2-support",
+        "guides/installation/loadbalancing-example/loadbalancing-example",
+      ],
+    },
     {
       type: "category",
       label: "Integrations",

docs/src/pages/index.js

@@ -67,8 +67,8 @@ const features = [
               description=""
             />
             <ListElement
-              link="docs/guides/installation"
-              type={ICONTYPE.STORAGE}
+              link="docs/guides/installation/run"
+              type={ICONTYPE.SYSTEM}
               title="Installation"
               description=""
             />