From 75ec1624a3bb2e8431e400dcab670812c8a388c9 Mon Sep 17 00:00:00 2001
From: Benedikt Rollik <brollik@online.net>
Date: Mon, 10 Mar 2025 14:42:05 +0100
Subject: [PATCH 1/4] feat(em): add troubleshooting index

---
 menu/navigation.json                          | 30 --------
 pages/elastic-metal/troubleshooting/index.mdx | 70 +++++++++++++++++--
 2 files changed, 66 insertions(+), 34 deletions(-)

diff --git a/menu/navigation.json b/menu/navigation.json
index e2f10ffcc4..8eb0fabc91 100644
--- a/menu/navigation.json
+++ b/menu/navigation.json
@@ -1304,36 +1304,6 @@
                 "slug": "how-to"
               },
               {
-                "items": [
-                  {
-                    "label": "Troubleshooting SSH connection issues on Elastic Metal servers",
-                    "slug": "troubleshoot-ssh-issues"
-                  },
-                  {
-                    "label": "Troubleshooting common Elastic Metal server access issues",
-                    "slug": "troubleshoot-access-issues"
-                  },
-                  {
-                    "label": "Troubleshooting an Elastic Metal server blocked installation",
-                    "slug": "troubleshoot-installation"
-                  },
-                  {
-                    "label": "Troubleshooting remote access (KVM over IP) issues on Elastic Metal servers",
-                    "slug": "troubleshoot-remote-access-issues"
-                  },
-                  {
-                    "label": "Replacing a failed drive in a software RAID",
-                    "slug": "replace-failed-drive-software-raid"
-                  },
-                  {
-                    "label": "Enabling SSH on Elastic Metal servers running virtualization distributions",
-                    "slug": "enable-ssh-virtualization-distribution"
-                  },
-                  {
-                    "label": "Resetting the Administrator password on servers running Windows Server",
-                    "slug": "reset-admin-password-windows-server"
-                  }
-                ],
                 "label": "Troubleshooting",
                 "slug": "troubleshooting"
               },
diff --git a/pages/elastic-metal/troubleshooting/index.mdx b/pages/elastic-metal/troubleshooting/index.mdx
index cc075219d0..e4d01c15d0 100644
--- a/pages/elastic-metal/troubleshooting/index.mdx
+++ b/pages/elastic-metal/troubleshooting/index.mdx
@@ -1,8 +1,70 @@
 ---
 meta:
   title: Elastic Metal - Troubleshooting
-  description: Elastic Metal Troubleshooting
+  description: Find troubleshooting resources for resolving issues with Elastic Metal.
 content:
-  h1: Elastic Metal - Troubleshooting
-  paragraph: Elastic Metal Troubleshooting
----
\ No newline at end of file
+  paragraph: Find troubleshooting resources for resolving issues with Elastic Metal.
+dates:
+  posted: 2025-03-10
+categories:
+  - elastic-metal
+---
+
+<ProductHeader
+  productName="Elastic Metal troubleshooting"
+  productLogo="elasticMetal"
+  description="Troubleshoot common issues with Scaleway Elastic Metal servers. Find solutions to help resolve problems and get started."
+/>
+
+## Featured Pages
+
+<Grid>
+    <DefaultCards
+      title="Elastic Metal FAQ"
+      description="General info on Elastic Metal servers"
+      url="/faq/elastic-metal/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Elastic Metal server datasheet"
+      description="This datasheet provides an overview of the technical specifications for the different Elastic Metal server offers."
+      url="/elastic-metal/reference-content/elastic-metal-datasheet/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Troubleshooting common Elastic Metal server access issues"
+      description="This page provides guidelines how to troubleshoot the most common server access issues."
+      url="/elastic-metal/troubleshooting/troubleshoot-access-issues/"
+      label="See more"
+    />
+</Grid>
+<Grid>
+    <DefaultCard
+      title="Enabling SSH on Elastic Metal servers running virtualization distributions"
+      description="This guide explains how to enable the SSH server on Virtualization distributions"
+      url="/elastic-metal/troubleshooting/enable-ssh-virtualization-distribution/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Replacing a failed drive in a RAID1 software RAID"
+      description="This guide explains how to replace a failed drive and rebuild the RAID1 array using the mdadm utility."
+      url="/elastic-metal/troubleshooting/replace-failed-drive-software-raid/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Elastic Metal"
+      description="Our shared responsibility model clarifies the division of duties between Scaleway and our users."
+      url="/elastic-metal/reference-content/shared-responsibility-model/"
+      label="See more"
+    />
+</Grid>
+
+## Elastic Metal troubleshooting pages 
+
+- [Enabling SSH on Elastic Metal servers running virtualization distributions](/elastic-metal/troubleshooting/enable-ssh-virtualization-distribution/)
+- [Replacing a failed drive in a RAID1 software RAID](/elastic-metal/troubleshooting/replace-failed-drive-software-raid/)
+- [Resetting the Administrator password on Windows Server OS](/elastic-metal/troubleshooting/reset-admin-password-windows-server/)
+- [Troubleshooting common Elastic Metal server access issues](/elastic-metal/troubleshooting/troubleshoot-access-issues/)
+- [Troubleshooting an Elastic Metal server blocked installation](/elastic-metal/troubleshooting/troubleshoot-installation/)
+- [Troubleshooting remote access (KVM over IP) issues on Elastic Metal servers](/elastic-metal/troubleshooting/troubleshoot-remote-access-issues/)
+- [Troubleshooting SSH connection issues on Elastic Metal servers](/elastic-metal/troubleshooting/troubleshoot-ssh-issues/)

From aee0d6c4ba1298f8b819606a5e29c27d738b9a9e Mon Sep 17 00:00:00 2001
From: Benedikt Rollik <brollik@online.net>
Date: Mon, 10 Mar 2025 15:00:05 +0100
Subject: [PATCH 2/4] fix(em): reset navigation

---
 menu/navigation.json | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/menu/navigation.json b/menu/navigation.json
index 8eb0fabc91..e2f10ffcc4 100644
--- a/menu/navigation.json
+++ b/menu/navigation.json
@@ -1304,6 +1304,36 @@
                 "slug": "how-to"
               },
               {
+                "items": [
+                  {
+                    "label": "Troubleshooting SSH connection issues on Elastic Metal servers",
+                    "slug": "troubleshoot-ssh-issues"
+                  },
+                  {
+                    "label": "Troubleshooting common Elastic Metal server access issues",
+                    "slug": "troubleshoot-access-issues"
+                  },
+                  {
+                    "label": "Troubleshooting an Elastic Metal server blocked installation",
+                    "slug": "troubleshoot-installation"
+                  },
+                  {
+                    "label": "Troubleshooting remote access (KVM over IP) issues on Elastic Metal servers",
+                    "slug": "troubleshoot-remote-access-issues"
+                  },
+                  {
+                    "label": "Replacing a failed drive in a software RAID",
+                    "slug": "replace-failed-drive-software-raid"
+                  },
+                  {
+                    "label": "Enabling SSH on Elastic Metal servers running virtualization distributions",
+                    "slug": "enable-ssh-virtualization-distribution"
+                  },
+                  {
+                    "label": "Resetting the Administrator password on servers running Windows Server",
+                    "slug": "reset-admin-password-windows-server"
+                  }
+                ],
                 "label": "Troubleshooting",
                 "slug": "troubleshooting"
               },

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

---
 pages/elastic-metal/troubleshooting/index.mdx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pages/elastic-metal/troubleshooting/index.mdx b/pages/elastic-metal/troubleshooting/index.mdx
index e4d01c15d0..0874e8e306 100644
--- a/pages/elastic-metal/troubleshooting/index.mdx
+++ b/pages/elastic-metal/troubleshooting/index.mdx
@@ -13,7 +13,7 @@ categories:
 <ProductHeader
   productName="Elastic Metal troubleshooting"
   productLogo="elasticMetal"
-  description="Troubleshoot common issues with Scaleway Elastic Metal servers. Find solutions to help resolve problems and get started."
+  description="Learn how to fix common issues with Scaleway Elastic Metal servers. Find solutions to help resolve problems and get started."
 />
 
 ## Featured Pages
@@ -21,7 +21,7 @@ categories:
 <Grid>
     <DefaultCards
       title="Elastic Metal FAQ"
-      description="General info on Elastic Metal servers"
+      description="General info on Elastic Metal servers."
       url="/faq/elastic-metal/"
       label="See more"
     />

From 009f912e957443bbe30ae1aea56c4345b884d401 Mon Sep 17 00:00:00 2001
From: Benedikt Rollik <brollik@scaleway.com>
Date: Wed, 12 Mar 2025 09:56:21 +0100
Subject: [PATCH 4/4] Apply suggestions from code review

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

diff --git a/pages/elastic-metal/troubleshooting/index.mdx b/pages/elastic-metal/troubleshooting/index.mdx
index 0874e8e306..b9d2665a5b 100644
--- a/pages/elastic-metal/troubleshooting/index.mdx
+++ b/pages/elastic-metal/troubleshooting/index.mdx
@@ -13,7 +13,7 @@ categories:
 <ProductHeader
   productName="Elastic Metal troubleshooting"
   productLogo="elasticMetal"
-  description="Learn how to fix common issues with Scaleway Elastic Metal servers. Find solutions to help resolve problems and get started."
+  description="Learn how to fix common issues with Scaleway Elastic Metal servers."
 />
 
 ## Featured Pages
@@ -27,33 +27,33 @@ categories:
     />
     <DefaultCard
       title="Elastic Metal server datasheet"
-      description="This datasheet provides an overview of the technical specifications for the different Elastic Metal server offers."
+      description="Get an overview of the technical specifications for the different Elastic Metal servers."
       url="/elastic-metal/reference-content/elastic-metal-datasheet/"
       label="See more"
     />
     <DefaultCard
       title="Troubleshooting common Elastic Metal server access issues"
-      description="This page provides guidelines how to troubleshoot the most common server access issues."
+      description="Learn how to solve the most common server access errors."
       url="/elastic-metal/troubleshooting/troubleshoot-access-issues/"
       label="See more"
     />
 </Grid>
 <Grid>
     <DefaultCard
-      title="Enabling SSH on Elastic Metal servers running virtualization distributions"
-      description="This guide explains how to enable the SSH server on Virtualization distributions"
+      title="Enabling SSH on Elastic Metal servers"
+      description="Learn to enable an SSH server on virtualization distributions."
       url="/elastic-metal/troubleshooting/enable-ssh-virtualization-distribution/"
       label="See more"
     />
     <DefaultCard
       title="Replacing a failed drive in a RAID1 software RAID"
-      description="This guide explains how to replace a failed drive and rebuild the RAID1 array using the mdadm utility."
+      description="Replace a failed drive and rebuild the RAID1 array using the mdadm utility."
       url="/elastic-metal/troubleshooting/replace-failed-drive-software-raid/"
       label="See more"
     />
     <DefaultCard
-      title="Elastic Metal"
-      description="Our shared responsibility model clarifies the division of duties between Scaleway and our users."
+      title="Elastic Metal shared responsibility"
+      description="Understand the division of duties between Scaleway and our users."
       url="/elastic-metal/reference-content/shared-responsibility-model/"
       label="See more"
     />