From a9c7fb74c5af3b7a19e8c0e4d50fc12a00b62021 Mon Sep 17 00:00:00 2001
From: Benedikt Rollik <brollik@online.net>
Date: Mon, 10 Mar 2025 13:24:14 +0100
Subject: [PATCH 1/3] feat(k8s): add troubleshooting index

---
 menu/navigation.json                       |  4 ++
 pages/kubernetes/troubleshooting/index.mdx | 63 ++++++++++++++++++++--
 2 files changed, 64 insertions(+), 3 deletions(-)

diff --git a/menu/navigation.json b/menu/navigation.json
index e2f10ffcc4..65ef7e9a44 100644
--- a/menu/navigation.json
+++ b/menu/navigation.json
@@ -2149,6 +2149,10 @@
               },
               {
                 "items": [
+                  {
+                    "label": "Overview",
+                    "slug": "../troubleshooting"
+                  },
                   {
                     "label": "Configuring a SQL storage backend in Helm",
                     "slug": "configuring-sql-storage-backend-helm"
diff --git a/pages/kubernetes/troubleshooting/index.mdx b/pages/kubernetes/troubleshooting/index.mdx
index d3a9b937ec..c0bfc90626 100644
--- a/pages/kubernetes/troubleshooting/index.mdx
+++ b/pages/kubernetes/troubleshooting/index.mdx
@@ -1,8 +1,65 @@
 ---
 meta:
   title: Kubernetes - Troubleshooting
-  description: Kubernetes troubleshooting
+  description: Find troubleshooting resources for resolving issues with Kubernetes.
 content:
-  h1: Kubernetes - Troubleshooting
-  paragraph: Kubernetes troubleshooting
+  paragraph: Find troubleshooting resources for resolving issues with Kubernetes.
+dates:
+  posted: 2025-03-10
+categories:
+  - serverless
 ---
+
+<ProductHeader
+  productName="Kubernetes troubleshooting"
+  productLogo="k8sKapsule"
+  description="Discover troubleshooting guidelines for Scaleway's Managed Kubernetes Kapsule and Kosmos products."
+/>
+
+## Featured Pages
+
+<Grid>
+    <DefaultCard
+      title="Kubernetes FAQ"
+      description="General info on Kubernetes products"
+      url="/faq/kubernetes/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Kubernetes Cheatsheet"
+      description="A handy cheatshet with the most common kubectl commands"
+      url="/kubernetes/reference-content/kubernetes-cheatsheet/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Managed Kubernetes service definition"
+      description="Scaleway Kapsule and Kosmos are managed Kubernetes services. "
+      url="/kubernetes/reference-content/managed-kubernetes-service-definition/"
+      label="See more"
+    />
+</Grid>
+<Grid>
+    <DefaultCard
+      title="Kubernetes version support policy"
+      description="Learn about Scaleway's Kubernetes version support policy"
+      url="/kubernetes/reference-content/version-support-policy/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Scaleway Kubernetes Kapsule autoheal feature"
+      description="The Scaleway Kubernetes Kapsule autoheal feature is designed to automatically detect and recover from failures within a Kubernetes cluster."
+      url="/kubernetes/reference-content/using-kapsule-autoheal-feature/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Kubernetes - Videos"
+      description="Learn how to get started with your Kubernetes cluster by following our video tutorials."
+      url="/kubernetes/videos/"
+      label="See more"
+    />
+</Grid>
+
+## Kubernetes troubleshooting pages
+
+- [Configuring a SQL storage backend in Helm on Scaleway Kubernetes Kapsule](/kubernetes/troubleshooting/configuring-sql-storage-backend-helm/)
+- [Containers are not starting on ARM Instances](/kubernetes/troubleshooting/containers-not-starting-arm-instances/)

From fa67e70fe013c5b70b3608da8c1f8e14163c7d60 Mon Sep 17 00:00:00 2001
From: Benedikt Rollik <brollik@scaleway.com>
Date: Mon, 10 Mar 2025 14:58:12 +0100
Subject: [PATCH 2/3] Update menu/navigation.json

---
 menu/navigation.json | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/menu/navigation.json b/menu/navigation.json
index 65ef7e9a44..e2f10ffcc4 100644
--- a/menu/navigation.json
+++ b/menu/navigation.json
@@ -2149,10 +2149,6 @@
               },
               {
                 "items": [
-                  {
-                    "label": "Overview",
-                    "slug": "../troubleshooting"
-                  },
                   {
                     "label": "Configuring a SQL storage backend in Helm",
                     "slug": "configuring-sql-storage-backend-helm"

From a6f0c14f685ffe2791da264f8ad3fc085f8dbeff Mon Sep 17 00:00:00 2001
From: Benedikt Rollik <brollik@scaleway.com>
Date: Tue, 11 Mar 2025 11:04:57 +0100
Subject: [PATCH 3/3] Apply suggestions from code review

Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com>
---
 pages/kubernetes/troubleshooting/index.mdx | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/pages/kubernetes/troubleshooting/index.mdx b/pages/kubernetes/troubleshooting/index.mdx
index c0bfc90626..a508841b22 100644
--- a/pages/kubernetes/troubleshooting/index.mdx
+++ b/pages/kubernetes/troubleshooting/index.mdx
@@ -13,7 +13,7 @@ categories:
 <ProductHeader
   productName="Kubernetes troubleshooting"
   productLogo="k8sKapsule"
-  description="Discover troubleshooting guidelines for Scaleway's Managed Kubernetes Kapsule and Kosmos products."
+  description="Discover how to solve the most common issues for Scaleway's Kubernetes Kapsule and Kosmos."
 />
 
 ## Featured Pages
@@ -21,19 +21,19 @@ categories:
 <Grid>
     <DefaultCard
       title="Kubernetes FAQ"
-      description="General info on Kubernetes products"
+      description="General info on Kubernetes products."
       url="/faq/kubernetes/"
       label="See more"
     />
     <DefaultCard
       title="Kubernetes Cheatsheet"
-      description="A handy cheatshet with the most common kubectl commands"
+      description="A handy cheatshet with the most common kubectl commands."
       url="/kubernetes/reference-content/kubernetes-cheatsheet/"
       label="See more"
     />
     <DefaultCard
       title="Managed Kubernetes service definition"
-      description="Scaleway Kapsule and Kosmos are managed Kubernetes services. "
+      description="Detailed information on Kubernetes definitions, functioning, and responsibilities."
       url="/kubernetes/reference-content/managed-kubernetes-service-definition/"
       label="See more"
     />
@@ -41,13 +41,13 @@ categories:
 <Grid>
     <DefaultCard
       title="Kubernetes version support policy"
-      description="Learn about Scaleway's Kubernetes version support policy"
+      description="Learn about Scaleway's Kubernetes version support policy."
       url="/kubernetes/reference-content/version-support-policy/"
       label="See more"
     />
     <DefaultCard
-      title="Scaleway Kubernetes Kapsule autoheal feature"
-      description="The Scaleway Kubernetes Kapsule autoheal feature is designed to automatically detect and recover from failures within a Kubernetes cluster."
+      title="Scaleway Kubernetes Kapsule autoheal"
+      description="A feature designed to automatically detect and recover from failures within a Kubernetes cluster."
       url="/kubernetes/reference-content/using-kapsule-autoheal-feature/"
       label="See more"
     />