feat(iam): add troubleshooting index (#4627)

Author: ldecarvalho-doc

menu/navigation.json

@@ -414,15 +414,15 @@
               {
                 "items": [
                   {
-                    "label": "IAM Overview",
+                    "label": "Understanding Scaleway IAM",
                     "slug": "overview"
                   },
                   {
                     "label": "Users, groups and applications",
                     "slug": "users-groups-and-applications"
                   },
                   {
-                    "label": "Policies",
+                    "label": "Understanding IAM Policies",
                     "slug": "policy"
                   },
                   {

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:

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:

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
----
+  paragraph: Find troubleshooting resources for resolving issues with IAM.
+dates:
+  posted: 2025-03-17
+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 IAM features."
+      url="/iam/how-to/add-payment-method/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Understanding IAM Policies"
+      description="Detailed information about IAM policies."
+      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 permissions for 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)