From 6a7817982b5a6c1be9740be275ae1feab1b55bd1 Mon Sep 17 00:00:00 2001
From: Dorota Wojcik <dorota.wojcik@aiven.io>
Date: Fri, 13 Dec 2024 12:51:19 +0100
Subject: [PATCH] doc structure reorg

---
 docs/platform/howto/google-cloud-functions.md |  1 +
 .../list-vpc-peering.md}                      |  0
 ...ering.md => manage-org-vpc-peering-aws.md} |  2 +-
 docs/platform/howto/vnet-peering-azure.md     |  1 +
 docs/platform/howto/vpc-peering-aws.md        |  1 +
 docs/platform/howto/vpc-peering-gcp.md        |  1 +
 docs/platform/howto/vpc-peering-upcloud.md    |  1 +
 sidebars.ts                                   | 23 +++++++++++++------
 8 files changed, 22 insertions(+), 8 deletions(-)
 rename docs/platform/{concepts/vpc-peering.md => howto/list-vpc-peering.md} (100%)
 rename docs/platform/howto/{manage-org-vpc-peering.md => manage-org-vpc-peering-aws.md} (98%)

diff --git a/docs/platform/howto/google-cloud-functions.md b/docs/platform/howto/google-cloud-functions.md
index 23e1642d..e5cbe722 100644
--- a/docs/platform/howto/google-cloud-functions.md
+++ b/docs/platform/howto/google-cloud-functions.md
@@ -1,5 +1,6 @@
 ---
 title: Access Aiven services from Google Cloud Functions via VPC peering
+sidebar_label: Access services from GCF via VPC peering
 ---
 
 You can access Aiven service by creating a **Serverless VPC access connector** and **Google Cloud Function**.
diff --git a/docs/platform/concepts/vpc-peering.md b/docs/platform/howto/list-vpc-peering.md
similarity index 100%
rename from docs/platform/concepts/vpc-peering.md
rename to docs/platform/howto/list-vpc-peering.md
diff --git a/docs/platform/howto/manage-org-vpc-peering.md b/docs/platform/howto/manage-org-vpc-peering-aws.md
similarity index 98%
rename from docs/platform/howto/manage-org-vpc-peering.md
rename to docs/platform/howto/manage-org-vpc-peering-aws.md
index 96cb159b..c30265b3 100644
--- a/docs/platform/howto/manage-org-vpc-peering.md
+++ b/docs/platform/howto/manage-org-vpc-peering-aws.md
@@ -1,6 +1,6 @@
 ---
 title: Manage organization VPC peering with AWS
-sidebar_label: Org VPC peering with AWS
+sidebar_label: Peer org VPCs with AWS
 ---
 
 import ConsoleLabel from "@site/src/components/ConsoleIcons";
diff --git a/docs/platform/howto/vnet-peering-azure.md b/docs/platform/howto/vnet-peering-azure.md
index 3fb02d75..53514317 100644
--- a/docs/platform/howto/vnet-peering-azure.md
+++ b/docs/platform/howto/vnet-peering-azure.md
@@ -1,5 +1,6 @@
 ---
 title: Set up VPC peering on Azure
+sidebar_label: Peer project VPCs with Azure
 ---
 
 Create an isolated Microsoft Azure virtual network in your Aiven deployment where you can create services instead of using Aiven Cloud's public network.
diff --git a/docs/platform/howto/vpc-peering-aws.md b/docs/platform/howto/vpc-peering-aws.md
index bf181cc9..60607c42 100644
--- a/docs/platform/howto/vpc-peering-aws.md
+++ b/docs/platform/howto/vpc-peering-aws.md
@@ -1,5 +1,6 @@
 ---
 title: Set up VPC peering on AWS
+sidebar_label: Peer project VPCs with AWS
 ---
 
 import ConsoleLabel from "@site/src/components/ConsoleIcons"
diff --git a/docs/platform/howto/vpc-peering-gcp.md b/docs/platform/howto/vpc-peering-gcp.md
index c8a2e2e5..d4eec092 100644
--- a/docs/platform/howto/vpc-peering-gcp.md
+++ b/docs/platform/howto/vpc-peering-gcp.md
@@ -1,5 +1,6 @@
 ---
 title: Set up VPC peering on GCP
+sidebar_label: Peer project VPCs with Google
 ---
 
 Once you've created a [VPC on the Aiven platform](manage-project-vpc), you can set up VPC peering on GCP.
diff --git a/docs/platform/howto/vpc-peering-upcloud.md b/docs/platform/howto/vpc-peering-upcloud.md
index cd396551..5c5b67f9 100644
--- a/docs/platform/howto/vpc-peering-upcloud.md
+++ b/docs/platform/howto/vpc-peering-upcloud.md
@@ -1,5 +1,6 @@
 ---
 title: Set up VPC peering on UpCloud
+sidebar_label: Peer project VPCs with UpCloud
 ---
 
 import UpcloudVpcPeering from "@site/static/images/content/platform/howto/upcloud-vpc-peer.png";
diff --git a/sidebars.ts b/sidebars.ts
index 05d71fec..fbacbbba 100644
--- a/sidebars.ts
+++ b/sidebars.ts
@@ -256,16 +256,25 @@ const sidebars: SidebarsConfig = {
                 id: 'platform/concepts/vpcs',
               },
               items: [
-                'platform/concepts/vpc-peering',
                 'platform/howto/manage-project-vpc',
                 'platform/howto/manage-organization-vpc',
-                'platform/howto/manage-org-vpc-peering',
+                {
+                  type: 'category',
+                  label: 'VPC peering',
+                  link: {
+                    type:'doc',
+                    id: 'platform/howto/list-vpc-peering',
+                  },
+                  items: [
+                    'platform/howto/vpc-peering-gcp',
+                    'platform/howto/vpc-peering-aws',
+                    'platform/howto/vnet-peering-azure',
+                    'platform/howto/vpc-peering-upcloud',
+                    'platform/howto/manage-org-vpc-peering-aws',
+                    'platform/howto/google-cloud-functions',
+                  ],
+                },
                 'platform/howto/public-access-in-vpc',
-                'platform/howto/vpc-peering-gcp',
-                'platform/howto/vpc-peering-aws',
-                'platform/howto/vnet-peering-azure',
-                'platform/howto/vpc-peering-upcloud',
-                'platform/howto/google-cloud-functions',
                 'platform/howto/attach-vpc-aws-tgw',
                 {
                   type: 'category',