From a8296d618507c29166e77dc8f229a0e7d9d412f3 Mon Sep 17 00:00:00 2001
From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com>
Date: Fri, 14 Mar 2025 16:55:53 +0100
Subject: [PATCH 1/2] feat(iam): add troubleshooting index

---
 menu/navigation.json                     |  4 +-
 pages/iam/reference-content/overview.mdx |  4 +-
 pages/iam/reference-content/policy.mdx   |  4 +-
 pages/iam/troubleshooting/index.mdx      | 60 ++++++++++++++++++++++--
 4 files changed, 61 insertions(+), 11 deletions(-)

diff --git a/menu/navigation.json b/menu/navigation.json
index fe5fc1b4ea..c44cfe886d 100644
--- a/menu/navigation.json
+++ b/menu/navigation.json
@@ -414,7 +414,7 @@
               {
                 "items": [
                   {
-                    "label": "IAM Overview",
+                    "label": "Understanding Scaleway IAM",
                     "slug": "overview"
                   },
                   {
@@ -422,7 +422,7 @@
                     "slug": "users-groups-and-applications"
                   },
                   {
-                    "label": "Policies",
+                    "label": "Understanding IAM Policies",
                     "slug": "policy"
                   },
                   {
diff --git a/pages/iam/reference-content/overview.mdx b/pages/iam/reference-content/overview.mdx
index 21188d7695..21e484ff63 100644
--- a/pages/iam/reference-content/overview.mdx
+++ b/pages/iam/reference-content/overview.mdx
@@ -1,9 +1,9 @@
 ---
 meta:
-  title: IAM Overview
+  title: Understanding Scaleway IAM
   description: High-level overview of Scaleway IAM features.
 content:
-  h1: IAM Overview
+  h1: Understanding Scaleway IAM
   paragraph: High-level overview of Scaleway IAM features.
 tags: iam
 dates:
diff --git a/pages/iam/reference-content/policy.mdx b/pages/iam/reference-content/policy.mdx
index 9d0761c2ae..a328bcd09f 100644
--- a/pages/iam/reference-content/policy.mdx
+++ b/pages/iam/reference-content/policy.mdx
@@ -1,9 +1,9 @@
 ---
 meta:
-  title: IAM Policies
+  title: Understanding IAM Policies
   description: Detailed additional content for policies within Scaleway IAM.
 content:
-  h1: Policies
+  h1: Understanding IAM Policies
   paragraph: Detailed additional content for policies within Scaleway IAM.
 tags: iam
 dates:
diff --git a/pages/iam/troubleshooting/index.mdx b/pages/iam/troubleshooting/index.mdx
index b9d2ff75f2..efc3e5e412 100644
--- a/pages/iam/troubleshooting/index.mdx
+++ b/pages/iam/troubleshooting/index.mdx
@@ -1,8 +1,58 @@
 ---
 meta:
-  title: IAM - Troubleshooting
-  description: IAM Troubleshooting
+  title: IAM (Identity and Access Management) - Troubleshooting
+  description: Find troubleshooting resources for resolving issues with IAM.
 content:
-  h1: Troubleshooting
-  paragraph: IAM Troubleshooting
----
\ No newline at end of file
+  paragraph: Find troubleshooting resources for resolving issues with IAM.
+dates:
+  posted: 2023-10-05
+categories:
+  - iam
+---
+
+<ProductHeader
+  productName="IAM troubleshooting"
+  productLogo="iam"
+  description="Discover how to solve the most common issues with Scaleway IAM."
+/>
+
+## Featured Pages
+
+<Grid>
+    <DefaultCard
+      title="IAM FAQ"
+      description="General info on Scaleway IAM."
+      url="/faq/iam/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Understanding Scaleway IAM"
+      description="A detailed overview of Scaleway IAM features."
+      url="/iam/how-to/add-payment-method/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Understanding IAM Policies"
+      description="Detailed additional content for policies within Scaleway IAM."
+      url="/iam/reference-content/policy/"
+      label="See more"
+    />
+</Grid>
+<Grid>
+    <DefaultCard
+      title="Using IAM API keys with Object Storage"
+      description="This page explains how to use IAM API keys with Object Storage"
+      url="/iam/api-cli/using-api-key-object-storage/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Permission sets reference"
+      description="Explore how to define and manage permission sets for user access control."
+      url="/iam/reference-content/permission-sets/"
+      label="See more"
+    />
+</Grid>
+
+## IAM troubleshooting pages
+
+- [I am not allowed to perform actions on resources](/iam/troubleshooting/cannot-use-resources)

From ae172a1bbada2bc3421d8b5c1b3d7a44daf2e06c Mon Sep 17 00:00:00 2001
From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com>
Date: Mon, 17 Mar 2025 11:55:16 +0100
Subject: [PATCH 2/2] feat(iam): fix card texts

---
 pages/iam/troubleshooting/index.mdx | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/pages/iam/troubleshooting/index.mdx b/pages/iam/troubleshooting/index.mdx
index efc3e5e412..2dcf4385d7 100644
--- a/pages/iam/troubleshooting/index.mdx
+++ b/pages/iam/troubleshooting/index.mdx
@@ -5,7 +5,7 @@ meta:
 content:
   paragraph: Find troubleshooting resources for resolving issues with IAM.
 dates:
-  posted: 2023-10-05
+  posted: 2025-03-17
 categories:
   - iam
 ---
@@ -27,13 +27,13 @@ categories:
     />
     <DefaultCard
       title="Understanding Scaleway IAM"
-      description="A detailed overview of Scaleway IAM features."
+      description="A detailed overview of IAM features."
       url="/iam/how-to/add-payment-method/"
       label="See more"
     />
     <DefaultCard
       title="Understanding IAM Policies"
-      description="Detailed additional content for policies within Scaleway IAM."
+      description="Detailed information about IAM policies."
       url="/iam/reference-content/policy/"
       label="See more"
     />
@@ -47,7 +47,7 @@ categories:
     />
     <DefaultCard
       title="Permission sets reference"
-      description="Explore how to define and manage permission sets for user access control."
+      description="Explore how to define and manage permissions for access control."
       url="/iam/reference-content/permission-sets/"
       label="See more"
     />