From bfdf1780954716103ddbaf5fcbb79adff52d9643 Mon Sep 17 00:00:00 2001
From: SamyOubouaziz <soubouaziz@scaleway.com>
Date: Wed, 12 Mar 2025 17:55:49 +0100
Subject: [PATCH 1/5] docs(gen): add troubleshooting indexes MTA-5747

---
 pages/block-storage/troubleshooting/index.mdx | 38 ++++++++++++
 .../object-storage/troubleshooting/index.mdx  | 61 +++++++++++++++++++
 2 files changed, 99 insertions(+)
 create mode 100644 pages/block-storage/troubleshooting/index.mdx

diff --git a/pages/block-storage/troubleshooting/index.mdx b/pages/block-storage/troubleshooting/index.mdx
new file mode 100644
index 0000000000..a3d6ad414f
--- /dev/null
+++ b/pages/block-storage/troubleshooting/index.mdx
@@ -0,0 +1,38 @@
+---
+meta:
+  title: Block Storage - Troubleshooting
+  description: $desc Find troubleshooting resources for resolving issues with Scaleway Block Storage.
+content:
+  paragraph: *desc 
+dates:
+  posted: 2025-03-12
+  validation: 2025-03-12
+categories:
+  - serverless
+---
+<ProductHeader
+  productName="Block Storage troubleshooting"
+  productLogo="blockStorage"
+  description="Find resources for resolving issues with Scaleway Block Storage"
+/>
+## Featured Pages
+<Grid>
+    <DefaultCard 
+      title="Block Storage FAQ"
+      description="General info on Block Storage"
+      url="/faq/block-storage/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Different Block Storage volume types"
+      description="Learn about different types of blocks."
+      url="/block-storage/reference-content/differences-between-5kiops-volumes/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Migrating from Instances API to Block Storage API"
+      description="Advantages of migration."
+      url="/#"
+      label="See more"
+    />
+</Grid>
diff --git a/pages/object-storage/troubleshooting/index.mdx b/pages/object-storage/troubleshooting/index.mdx
index 429ceba60d..6deec1342d 100644
--- a/pages/object-storage/troubleshooting/index.mdx
+++ b/pages/object-storage/troubleshooting/index.mdx
@@ -5,4 +5,65 @@ meta:
 content:
   h1: Object Storage - Troubleshooting
   paragraph: Resolve common issues with Scaleway Object Storage.
+dates:
+  posted: 2025-03-12
+  validation: 2025-03-12
+categories:
+  - object-storage
 ---
+
+<ProductHeader
+  productName="Object Storage troubleshooting"
+  productLogo="objectStorage"
+  description="Resolve common issues with Scaleway Object Storage."
+/>
+
+## Featured Pages
+<Grid>
+    <DefaultCard 
+      title="Object Storage FAQ"
+      description="General information on Object Storage"
+      url="/faq/object-storage/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Bucket Policies Overview"
+      description="Information and examples on Bucket policies."
+      url="/object-storage/api-cli/bucket-policy/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="API calls list"
+      description="List of supported API calls."
+      url="/object-storage/api-cli/using-api-call-list/"
+      label="See more"
+    />
+</Grid>
+<Grid>
+    <DefaultCard 
+      title="Optimize your Object Storage performance"
+      description="Tips to optimize your deployment."
+      url="/object-storage/reference-content/optimize-object-storage-performance/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Amazon S3 and IAM permissions equivalence"
+      description="List of authorized operations per permissions set."
+      url="/object-storage/reference-content/s3-iam-permissions-equivalence/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Migrating data from one bucket to another"
+      description="Transfer objects between two buckets."
+      url="/object-storage/api-cli/migrating-buckets/"
+      label="See more"
+    />
+</Grid>
+## Object Storage troubleshooting pages 
+
+- [My API key does not work with Object Storage](/object-storage/troubleshooting/api-key-does-not-work/)
+- [I cannot access my data](/object-storage/troubleshooting/cannot-access-data/)
+- [I cannot delete my bucket](/object-storage/troubleshooting/cannot-delete-bucket/)
+- [I cannot restore my objects from Glacier](/object-storage/troubleshooting/cannot-restore-glacier/)
+- [I lost access to a bucket after applying a bucket policy](/object-storage/troubleshooting/lost-bucket-access-bucket-policy/)
+- [I am experiencing performance issues](/object-storage/troubleshooting/low-performance/)

From a91caab30c814f69932c99d50891b8a5cc1dab88 Mon Sep 17 00:00:00 2001
From: SamyOubouaziz <soubouaziz@scaleway.com>
Date: Thu, 13 Mar 2025 11:50:07 +0100
Subject: [PATCH 2/5] docs(gen): update

---
 .../troubleshooting/index.mdx                 | 65 ++++++++++++++++-
 .../troubleshooting/index.mdx                 | 72 ++++++++++++++++++-
 .../serverless-jobs/troubleshooting/index.mdx | 63 +++++++++++++++-
 3 files changed, 195 insertions(+), 5 deletions(-)

diff --git a/pages/serverless-containers/troubleshooting/index.mdx b/pages/serverless-containers/troubleshooting/index.mdx
index 705080cd5e..c5ef5a3cf7 100644
--- a/pages/serverless-containers/troubleshooting/index.mdx
+++ b/pages/serverless-containers/troubleshooting/index.mdx
@@ -5,4 +5,67 @@ meta:
 content:
   h1: Containers - Troubleshooting
   paragraph: Troubleshooting guide for Scaleway Serverless Containers.
----
\ No newline at end of file
+dates:
+  posted: 2025-03-13
+  validation: 2025-03-13
+categories:
+  - serverless
+---
+
+<ProductHeader
+  productName="Containers troubleshooting"
+  productLogo="containers"
+  description="Find resources for resolving issues with Scaleway Serverless Containers."
+/>
+
+## Featured Pages
+
+<Grid>
+    <DefaultCard 
+      title="Serverless Containers FAQ"
+      description="General info on Serverless Containers"
+      url="/faq/serverless-containers/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Methods to deploy Serverless Containers"
+      description="Discover several solutions to deploy your Containers."
+      url="/serverless-containers/reference-content/deploy-container/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Containers limitations" 
+      description="Technical limitations of Serverless Containers."
+      url="/serverless-containers/reference-content/containers-limitations/"
+      label="See more"
+    />
+</Grid>
+<Grid>
+    <DefaultCard 
+      title="Serverless Containers billing"
+      description="Detailed pricing model."
+      url="/serverless-containers/reference-content/containers-billing/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Serverless Containers autoscaling"
+      description="Get more info on scaling mechanism."
+      url="/serverless-containers/reference-content/containers-autoscaling/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Differences between Serverless Jobs, Containers and Functions"
+      description="Differences between Serverless products."
+      url="/serverless-containers/reference-content/difference-jobs-functions-containers/"
+      label="See more"
+    />
+</Grid>
+## Serverless Containers troubleshooting pages 
+
+- [I get an Error code 502](/serverless-containers/troubleshooting/502-error-when-scaling/)
+- [I am unable to create a Serverless Containers namespace](/serverless-containers/troubleshooting/cannot-create-namespace/)
+- [I am unable to deploy my image](/serverless-containers/troubleshooting/cannot-deploy-image/)
+- [My secrets and variables are not injected properly in my container](/serverless-containers/troubleshooting/cannot-inject-secret-variable/)
+- [I cannot retrieve an external image for my container](/serverless-containers/troubleshooting/cannot-retrieve-external-image/)
+[My container stopped working after a redeploy](/- serverless-containers/troubleshooting/container-stopped-after-redeploy/)
+- [Tests fail on Serverless Containers](/serverless-containers/troubleshooting/tests-fail-on-container/)
diff --git a/pages/serverless-functions/troubleshooting/index.mdx b/pages/serverless-functions/troubleshooting/index.mdx
index 18af1bd847..571b730d19 100644
--- a/pages/serverless-functions/troubleshooting/index.mdx
+++ b/pages/serverless-functions/troubleshooting/index.mdx
@@ -1,8 +1,74 @@
 ---
 meta:
   title: Functions - Troubleshooting
-  description: Find troubleshooting resources for resolving issues with Scaleway Serverless Functions.
+  description: Troubleshooting guide for Scaleway Serverless Functions.
 content:
   h1: Functions - Troubleshooting
-  paragraph: Find troubleshooting resources for resolving issues with Scaleway Serverless Functions.
----
\ No newline at end of file
+  paragraph: Troubleshooting guide for Scaleway Serverless Functions.
+dates:
+  posted: 2025-03-13
+  validation: 2025-03-13
+categories:
+  - serverless
+---
+
+<ProductHeader
+  productName="Functions troubleshooting"
+  productLogo="functions"
+  description="Find resources for resolving issues with Scaleway Serverless Functions."
+/>
+
+## Featured Pages
+
+<Grid>
+    <DefaultCard 
+      title="Serverless Functions FAQ"
+      description="General info on Serverless Functions"
+      url="/faq/serverless-functions/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Methods to deploy Serverless Functions"
+      description="Discover several solutions to deploy your Functions."
+      url="/serverless-functions/reference-content/deploy-function/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Functions limitations" 
+      description="Technical limitations of Serverless Functions."
+      url="/serverless-functions/reference-content/functions-limitations/"
+      label="See more"
+    />
+</Grid>
+<Grid>
+    <DefaultCard 
+      title="Serverless Functions billing"
+      description="Detailed pricing model."
+      url="/serverless-functions/reference-content/functions-billing/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Serverless Functions handler reference"
+      description="Understand the behavior of handlers."
+      url="/serverless-functions/reference-content/functions-handlers/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Differences between Serverless Jobs, Containers and Functions"
+      description="Differences between Serverless products."
+      url="/serverless-functions/reference-content/difference-jobs-functions-containers/"
+      label="See more"
+    />
+</Grid>
+
+## Serverless Functions troubleshooting pages 
+
+- [I am unable to create a Serverless Functions namespace](/serverless-functions/troubleshooting/cannot-create-namespace/)
+- [My secrets and variables are not injected properly in my function](/serverless-functions/troubleshooting/cannot-inject-secret-variable/)
+- [My function does not build properly](/serverless-functions/troubleshooting/function-build-error/)
+- [My function is in an error state](/serverless-functions/troubleshooting/function-in-error-state/)
+- [My function stopped working after a redeploy](/serverless-functions/troubleshooting/function-stopped-after-redeploy/)
+- [Unable to find the function handler](/serverless-functions/troubleshooting/handler-not-found/)
+- [Tests fail on Serverless Functions](/serverless-functions/troubleshooting/tests-fail-on-function/)
+- [I am experiencing timeout errors](/serverless-functions/troubleshooting/timeout-error/)
+- [My function fails after trying too many times](/serverless-functions/troubleshooting/too-many-retries/)
\ No newline at end of file
diff --git a/pages/serverless-jobs/troubleshooting/index.mdx b/pages/serverless-jobs/troubleshooting/index.mdx
index 88b5e62b57..87be4b7bb6 100644
--- a/pages/serverless-jobs/troubleshooting/index.mdx
+++ b/pages/serverless-jobs/troubleshooting/index.mdx
@@ -5,4 +5,65 @@ meta:
 content:
   h1: Jobs - Troubleshooting
   paragraph: Troubleshooting guide for Scaleway Serverless Jobs.
----
\ No newline at end of file
+dates:
+  posted: 2025-03-13
+  validation: 2025-03-13
+categories:
+  - serverless
+---
+
+<ProductHeader
+  productName="Jobs troubleshooting"
+  productLogo="Jobs"
+  description="Find resources for resolving issues with Scaleway Serverless Jobs."
+/>
+
+## Featured Pages
+
+<Grid>
+    <DefaultCard 
+      title="Serverless Jobs FAQ"
+      description="General info on Serverless Jobs"
+      url="/faq/serverless-jobs/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Methods to deploy Serverless Jobs"
+      description="Discover several solutions to deploy your Jobs."
+      url="/serverless-jobs/reference-content/deploy-job/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Jobs limitations" 
+      description="Technical limitations of Serverless Jobs."
+      url="/serverless-jobs/reference-content/Jobs-limitations/"
+      label="See more"
+    />
+</Grid>
+<Grid>
+    <DefaultCard 
+      title="Serverless Jobs billing"
+      description="Detailed pricing model."
+      url="/serverless-jobs/reference-content/Jobs-billing/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Serverless Jobs handler reference"
+      description="Understand the behavior of handlers."
+      url="/serverless-jobs/reference-content/Jobs-handlers/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Differences between Serverless Jobs, Containers and Functions"
+      description="Differences between Serverless products."
+      url="/serverless-jobs/reference-content/difference-jobs-functions-containers/"
+      label="See more"
+    />
+</Grid>
+
+## Serverless Jobs troubleshooting pages 
+
+- [My secrets and variables are not injected properly in my job](/serverless-jobs/troubleshooting/cannot-inject-secret-variable/)
+- [I cannot retrieve an external image for my job](/serverless-jobs/troubleshooting/cannot-retrieve-external-image/)
+- [My Job run is in an error state](/serverless-jobs/troubleshooting/job-in-error-state/)
+- [Missing metrics for my Job Run](/serverless-jobs/troubleshooting/missing-metrics/)
\ No newline at end of file

From 59d7f7a8e66d0328e4c2c327a96c800fa70d564a Mon Sep 17 00:00:00 2001
From: SamyOubouaziz <soubouaziz@scaleway.com>
Date: Thu, 13 Mar 2025 14:03:13 +0100
Subject: [PATCH 3/5] docs(gen): update

---
 .../serverless-jobs/troubleshooting/index.mdx |  2 +-
 .../troubleshooting/index.mdx                 | 49 +++++++++++++++++--
 2 files changed, 46 insertions(+), 5 deletions(-)

diff --git a/pages/serverless-jobs/troubleshooting/index.mdx b/pages/serverless-jobs/troubleshooting/index.mdx
index 87be4b7bb6..4adc655525 100644
--- a/pages/serverless-jobs/troubleshooting/index.mdx
+++ b/pages/serverless-jobs/troubleshooting/index.mdx
@@ -14,7 +14,7 @@ categories:
 
 <ProductHeader
   productName="Jobs troubleshooting"
-  productLogo="Jobs"
+  productLogo="jobs"
   description="Find resources for resolving issues with Scaleway Serverless Jobs."
 />
 
diff --git a/pages/serverless-sql-databases/troubleshooting/index.mdx b/pages/serverless-sql-databases/troubleshooting/index.mdx
index 7bcf575170..899b9236f6 100644
--- a/pages/serverless-sql-databases/troubleshooting/index.mdx
+++ b/pages/serverless-sql-databases/troubleshooting/index.mdx
@@ -1,8 +1,49 @@
 ---
 meta:
-  title: SQL Databases - Troubleshooting
-  description: Comprehensive guide to troubleshooting Scaleway serverless SQL databases.
+  title: Serverless SQL Databases - Troubleshooting
+  description: Comprehensive guides to troubleshooting Scaleway Serverless SQL Databases.
 content:
-  h1: SQL Databases - Troubleshooting
-  paragraph: Comprehensive guide to troubleshooting Scaleway serverless SQL databases.
+  h1: Serverless SQL Databases - Troubleshooting
+  paragraph: Comprehensives guide to troubleshooting Scaleway Serverless SQL Databases.
+dates:
+  posted: 2025-03-13
+  validation: 2025-03-13
+ 
 ---
+
+
+<ProductHeader
+  productName="Serverless SQL Databases troubleshooting"
+  productLogo="serverlessDB"
+  description="Find resources for resolving issues with Scaleway Serverless SQL Databases."
+/>
+
+## Featured Pages
+
+<Grid>
+    <DefaultCard 
+      title="Serverless SQL Databases FAQ"
+      description="General info on Serverless SQL Databases"
+      url="/faq/serverless-sql-databases/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Differences between Serverless Databases and postgreSQL"
+      description="Known differences with default postgreSQL."
+      url="/serverless-sql-databases/reference-content/known-differences/"
+      label="See more"
+    />
+    <DefaultCard 
+      title="Serverless SQL Databases overview" 
+      description="Technical specifications of Serverless SQL Databases."
+      url="/serverless-sql-databases/reference-content/serverless-sql-databases-overview/"
+      label="See more"
+    />
+</Grid>
+
+## Serverless SQL Databases troubleshooting pages 
+
+- [Solving connection errors](/serverless-sql-databases/troubleshooting/connection-errors/)
+- [Solving Serverless SQL Databases connection timeouts](/serverless-sql-databases/troubleshooting/connection-timeout/)
+- [Solving failing manual backup and restore operations](/serverless-sql-databases/troubleshooting/failing-backup-restore/)
+- [Solving maximum prepared statements size errors](/serverless-sql-databases/troubleshooting/maximum-prepared-statements-reached/)
\ No newline at end of file

From 940364963dfc58030c04e91f086a85c15fb34718 Mon Sep 17 00:00:00 2001
From: SamyOubouaziz <soubouaziz@scaleway.com>
Date: Thu, 13 Mar 2025 14:12:01 +0100
Subject: [PATCH 4/5] docs(gen): update

---
 pages/data-lab/troubleshooting/index.mdx | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/pages/data-lab/troubleshooting/index.mdx b/pages/data-lab/troubleshooting/index.mdx
index b4d2aabd9c..3e85c9c78d 100644
--- a/pages/data-lab/troubleshooting/index.mdx
+++ b/pages/data-lab/troubleshooting/index.mdx
@@ -5,4 +5,28 @@ meta:
 content:
   h1: Distributed Data Lab Troubleshooting
   paragraph: Troubleshoot common issues with Scaleway Distributed Data Lab.
+dates:
+  posted: 2025-03-13
+  validation: 2025-03-13
 ---
+
+<ProductHeader
+  productName="Distributed Data Lab troubleshooting"
+  productLogo="distributedDataLab"
+  description="Find resources for resolving issues with Scaleway Distributed Data Lab."
+/>
+
+## Featured Pages
+
+<Grid>
+    <DefaultCard 
+      title="Distributed Data Lab FAQ"
+      description="General info on Data Labs."
+      url="/faq/serverless-sql-databases/"
+      label="See more"
+    />
+</Grid>
+
+## Distributed Data Lab troubleshooting pages
+
+- [Troubleshooting Distributed Data Lab execution issues](/data-lab/troubleshooting/cannot-run-data-lab/)

From ee3e79b6c13079c5d92136e9e4a855d0346fdbcc Mon Sep 17 00:00:00 2001
From: SamyOubouaziz <soubouaziz@scaleway.com>
Date: Mon, 17 Mar 2025 15:17:26 +0100
Subject: [PATCH 5/5] docs(gen): update

---
 pages/block-storage/troubleshooting/index.mdx         | 2 +-
 pages/object-storage/troubleshooting/index.mdx        | 2 +-
 pages/serverless-containers/troubleshooting/index.mdx | 2 +-
 pages/serverless-functions/troubleshooting/index.mdx  | 4 ++--
 pages/serverless-jobs/troubleshooting/index.mdx       | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/pages/block-storage/troubleshooting/index.mdx b/pages/block-storage/troubleshooting/index.mdx
index a3d6ad414f..4bf96956f9 100644
--- a/pages/block-storage/troubleshooting/index.mdx
+++ b/pages/block-storage/troubleshooting/index.mdx
@@ -19,7 +19,7 @@ categories:
 <Grid>
     <DefaultCard 
       title="Block Storage FAQ"
-      description="General info on Block Storage"
+      description="General info on Block Storage."
       url="/faq/block-storage/"
       label="See more"
     />
diff --git a/pages/object-storage/troubleshooting/index.mdx b/pages/object-storage/troubleshooting/index.mdx
index 6deec1342d..3c06dc9b49 100644
--- a/pages/object-storage/troubleshooting/index.mdx
+++ b/pages/object-storage/troubleshooting/index.mdx
@@ -48,7 +48,7 @@ categories:
     />
     <DefaultCard 
       title="Amazon S3 and IAM permissions equivalence"
-      description="List of authorized operations per permissions set."
+      description="Authorized operations per permissions set."
       url="/object-storage/reference-content/s3-iam-permissions-equivalence/"
       label="See more"
     />
diff --git a/pages/serverless-containers/troubleshooting/index.mdx b/pages/serverless-containers/troubleshooting/index.mdx
index c5ef5a3cf7..6019bc16e6 100644
--- a/pages/serverless-containers/troubleshooting/index.mdx
+++ b/pages/serverless-containers/troubleshooting/index.mdx
@@ -29,7 +29,7 @@ categories:
     />
     <DefaultCard 
       title="Methods to deploy Serverless Containers"
-      description="Discover several solutions to deploy your Containers."
+      description="Find the best way to deploy Containers."
       url="/serverless-containers/reference-content/deploy-container/"
       label="See more"
     />
diff --git a/pages/serverless-functions/troubleshooting/index.mdx b/pages/serverless-functions/troubleshooting/index.mdx
index 571b730d19..787f6824d0 100644
--- a/pages/serverless-functions/troubleshooting/index.mdx
+++ b/pages/serverless-functions/troubleshooting/index.mdx
@@ -23,13 +23,13 @@ categories:
 <Grid>
     <DefaultCard 
       title="Serverless Functions FAQ"
-      description="General info on Serverless Functions"
+      description="General info on Serverless Functions."
       url="/faq/serverless-functions/"
       label="See more"
     />
     <DefaultCard 
       title="Methods to deploy Serverless Functions"
-      description="Discover several solutions to deploy your Functions."
+      description="Find the best way to deploy Functions."
       url="/serverless-functions/reference-content/deploy-function/"
       label="See more"
     />
diff --git a/pages/serverless-jobs/troubleshooting/index.mdx b/pages/serverless-jobs/troubleshooting/index.mdx
index 4adc655525..bc2defd21b 100644
--- a/pages/serverless-jobs/troubleshooting/index.mdx
+++ b/pages/serverless-jobs/troubleshooting/index.mdx
@@ -29,7 +29,7 @@ categories:
     />
     <DefaultCard 
       title="Methods to deploy Serverless Jobs"
-      description="Discover several solutions to deploy your Jobs."
+      description="Find the best way to deploy Jobs."
       url="/serverless-jobs/reference-content/deploy-job/"
       label="See more"
     />