Merge pull request #21474 from dvdksn/sidebar-grouping

feat: sidebar groups

Author: dvdksn

content/manuals/_index.md

@@ -7,16 +7,13 @@ url: /manuals/
 layout: wide
 params:
   icon: description
+  sidebar:
+    groups:
+      - Open source
+      - Products
+      - Platform
   notoc: true
-  development:
-  - title: Docker Desktop
-    description: Your command center for container development.
-    icon: /assets/icons/Whale.svg
-    link: /desktop/
-  - title: Docker Compose
-    description: Define and run multi-container applications.
-    icon: /assets/icons/Compose.svg
-    link: /compose/
+  open-source:
   - title: Docker Build
     description: Build and ship any application anywhere.
     icon: build
@@ -25,11 +22,19 @@ params:
     description: The industry-leading container runtime.
     icon: developer_board
     link: /engine/
-  - title: Docker Extensions
-    description: Customize your Docker Desktop workflow.
-    icon: extension
-    link: /extensions/
-  services:
+  - title: Docker Compose
+    description: Define and run multi-container applications.
+    icon: /assets/icons/Compose.svg
+    link: /compose/
+  products:
+  - title: Docker Desktop
+    description: Your command center for container development.
+    icon: /assets/icons/Whale.svg
+    link: /desktop/
+  - title: Build Cloud
+    description: Build your images faster in the cloud.
+    icon: /assets/images/logo-build-cloud.svg
+    link: /build-cloud/
   - title: Docker Hub
     description: Discover, share, and integrate container images.
     icon: hub
@@ -38,50 +43,63 @@ params:
     description: Image analysis and policy evaluation.
     icon: /assets/icons/Scout.svg
     link: /scout/
-  - title: Trusted content
-    description: Curated, high-quality content from trusted sources.
-    icon: verified
-    link: /trusted-content/
-  - title: Build Cloud
-    description: Build your images faster in the cloud.
-    icon: /assets/images/logo-build-cloud.svg
-    link: /build-cloud/
-  admin:
+  - title: Docker for GitHub Copilot
+    description: Integrate Docker's capabilities with GitHub Copilot.
+    icon: chat
+    link: /copilot/
+  - title: Docker Extensions
+    description: Customize your Docker Desktop workflow.
+    icon: extension
+    link: /extensions/
+  - title: Testcontainers cloud
+    description: Run integration tests, with real dependencies, in the cloud.
+    icon: package_2
+    link: https://testcontainers.com/cloud/docs/
+  platform:
   - title: Administration
     description: Centralized observability for companies and organizations.
     icon: admin_panel_settings
     link: /admin/
-  - title: Security
-    description: Security guardrails for both administrators and developers.
-    icon: lock
-    link: /security/
   - title: Billing
     description: Manage billing and payment methods.
     icon: payments
     link: /billing/
+  - title: Accounts
+    description: Manage your Docker account.
+    icon: account_circle
+    link: /accounts/
+  - title: Security
+    description: Security guardrails for both administrators and developers.
+    icon: lock
+    link: /security/
   - title: Subscription
     description: Commercial use licenses for Docker products.
     icon: card_membership
     link: /subscription/
+  - title: Trusted content
+    description: Curated, high-quality content from trusted sources.
+    icon: verified
+    link: /trusted-content/
 ---
 
 This section contains user guides on how to install, set up, configure, and use
 Docker products.
 
-## Developer tools
+## Open source
 
-Software development and containerization technologies.
+Open source development and containerization technologies.
 
-{{< grid items=development >}}
+{{< grid items=open-source >}}
 
-## Services
+## Products
 
-Artifact management and supply chain security.
+End-to-end developer solutions for innovative teams.
 
-{{< grid items=services >}}
+{{< grid items=products >}}
 
-## Administration and accounts
+## Platform
 
-Administration and subscription management for organizations.
+Documentation related to the Docker platform, such as administration and
+subscription management for organizations.
 
-{{< grid items=admin >}}
+{{< grid items=platform >}}

content/manuals/accounts/_index.md

@@ -1,8 +1,10 @@
 ---
 title: Docker accounts
-weight: 200
 description: Learn how to create and manage your Docker account.
 keywords: accounts, docker ID, account management, account settings, docker account, docker home
+params:
+  sidebar:
+    group: Platform
 grid:
 - title: Create a Docker ID
   description: Get started with Docker and create an account.

content/manuals/admin/_index.md

@@ -1,8 +1,10 @@
 ---
 title: Administration
-weight: 200
 description: Discover manuals on administration for accounts, organizations, and companies.
 keywords: admin, administration, company, organization, Admin Console, user accounts, account management
+params:
+  sidebar:
+    group: Platform
 grid:
 - title: Company administration
   description: Explore how to manage a company.

content/manuals/billing/_index.md

@@ -1,9 +1,11 @@
 ---
 title: Billing and payments
 linkTitle: Billing
-weight: 200
 description: Discover information on billing and payment processes for Docker subscriptions.
 keywords: billing, invoice, payment, subscription
+params:
+  sidebar:
+    group: Platform
 grid_core:
 - title: Get started
   description: Learn how to set up a Docker Core subscription for a personal account or organization.

content/manuals/build-cloud/_index.md

@@ -1,8 +1,11 @@
 ---
 title: Docker Build Cloud
-weight: 100
+weight: 20
 description: Find documentation on Docker Build Cloud to help you build your container images faster, both locally and in CI
 keywords: build, cloud, cloud build, remote builder
+params:
+  sidebar:
+    group: Products
 aliases:
   - /build/cloud/faq/
   - /build/cloud/

content/manuals/build/_index.md

@@ -1,8 +1,11 @@
 ---
 title: Docker Build
-weight: 100
+weight: 20
 description: Get an overview of Docker Build to package and bundle your code and ship it anywhere
 keywords: build, buildx, buildkit
+params:
+  sidebar:
+    group: Open source
 grid:
 - title: Packaging your software
   description: 'Build and package your application to run it anywhere: locally or

content/manuals/cloud/index.md

@@ -2,6 +2,9 @@
 title: Cloud integrations
 description: ACI and ECS integration information
 keywords: compose, ACI, ECS, amazon, cloud integration
+params:
+  sidebar:
+    group: Products
 aliases:
 - /engine/context/aci-integration/
 - /cloud/aci-integration/

content/manuals/compose/_index.md

@@ -1,11 +1,14 @@
 ---
 title: Docker Compose
-weight: 100
+weight: 30
 description: Learn how to use Docker Compose to define and run multi-container applications
   with this detailed introduction to the tool.
 keywords: docker compose, docker-compose, docker compose command, docker compose files,
   docker compose documentation, using docker compose, compose container, docker compose
   service
+params:
+  sidebar:
+    group: Open source
 grid:
 - title: Why use Compose?
   description: Understand Docker Compose's key benefits

content/manuals/copilot/_index.md

@@ -2,10 +2,11 @@
 title: Docker for GitHub Copilot
 params:
   sidebar:
+    group: Products
     badge:
       color: violet
       text: EA
-weight: 100
+weight: 50
 description: |
   Learn how to streamline Docker-related tasks with the Docker for GitHub
   Copilot extension. This integration helps you generate Docker assets, analyze

content/manuals/desktop/_index.md

@@ -1,9 +1,12 @@
 ---
 title: Docker Desktop
-weight: 100
+weight: 10
 description: Explore Docker Desktop, what it has to offer, and its key features. Take the next step by downloading or find additional resources
 keywords: how to use docker desktop, what is docker desktop used for, what does docker
   desktop do, using docker desktop
+params:
+  sidebar:
+    group: Products
 grid:
 - title: Install Docker Desktop
   description: |