From faa980a9f389dc0091f3158bb2ce0b047cce0e76 Mon Sep 17 00:00:00 2001
From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
Date: Wed, 24 Apr 2024 08:54:26 -0700
Subject: [PATCH] add guides overview page (#19837)

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
---
 content/guides/_index.md | 72 ++++++++++++++++++++++++++++++++++++++++
 data/toc.yaml            |  2 ++
 hugo.yaml                |  2 +-
 layouts/index.html       |  5 ++-
 4 files changed, 77 insertions(+), 4 deletions(-)
 create mode 100644 content/guides/_index.md

diff --git a/content/guides/_index.md b/content/guides/_index.md
new file mode 100644
index 0000000000..4d294795e8
--- /dev/null
+++ b/content/guides/_index.md
@@ -0,0 +1,72 @@
+---
+title: Guides
+keywords: Docker guides
+description: Explore the Docker guides
+notoc: true
+
+get-started:
+- title: Docker overview
+  description: Learn about the Docker platform.
+  link: /get-started/overview/
+  icon: summarize
+- title: Get started
+  description: Get started with the basics and the benefits of containerizing your applications.
+  link: /guides/get-started/
+  icon: rocket
+- title: Docker concepts
+  description: Gain a better understanding of foundational Docker concepts.
+  link: /guides/docker-concepts/the-basics/what-is-a-container/
+  icon: foundation
+
+dive-deeper:
+- title: Langauge-specific guides
+  description: Learn how to containerize, develop, and test langauage-specific apps using Docker.
+  link: /language/
+  icon: code
+- title: Use-case guides
+  description: Walk through practical Docker applications for specific scenarios.
+  link: /guides/use-case/
+  icon: task
+- title: Develop with Docker
+  description: Master Docker best practices for efficient, secure development.
+  link: /develop/
+  icon: rule
+- title: Build with Docker
+  description: Deep-dive into building software with Docker.
+  link: /build/guide/
+  icon: build
+- title: Deployment and Orchestration
+  description: Deploy and manage Docker containers at scale.
+  link: /get-started/orchestration/
+  icon: workspaces
+
+resources:
+- title: Educational resources
+  description: Explore diverse Docker training and hands-on experiences.
+  link: /get-started/resources/
+  icon: book
+- title: Contribute to Docker's docs
+  description: Learn how to help contribute to Docker docs.
+  link: /contribute/
+  icon: edit
+---
+
+This section contains guides to help you get started and learn how Docker can optimize your development workflows.
+
+## Foundations of Docker
+
+Get started learning the foundational concepts and workflows of Docker.
+
+{{< grid items="get-started" >}}
+
+## Advancing with Docker
+
+Explore more advanced concepts and scenarios in Docker.
+
+{{< grid items="dive-deeper" >}}
+
+## Educational resources and contributions
+
+Discover community-driven resources and learn how to contribute to Docker docs.
+
+{{< grid items="resources" >}}
diff --git a/data/toc.yaml b/data/toc.yaml
index ffeedb23be..5506541bd6 100644
--- a/data/toc.yaml
+++ b/data/toc.yaml
@@ -1,4 +1,6 @@
 Guides:
+- title: Overview
+  path: /guides/
 - title: Docker overview
   path: /get-started/overview/
 - sectiontitle: Get started
diff --git a/hugo.yaml b/hugo.yaml
index 005001292e..ab4a8aa01c 100644
--- a/hugo.yaml
+++ b/hugo.yaml
@@ -118,7 +118,7 @@ params:
 menus:
   main:
   - name: Guides
-    url: /get-started/overview/
+    url: /guides/
     weight: 1
   - name: Manuals
     url: /manuals/
diff --git a/layouts/index.html b/layouts/index.html
index 5f4b1ce0ad..99924e4636 100644
--- a/layouts/index.html
+++ b/layouts/index.html
@@ -43,7 +43,7 @@
       <div>
         <div class="grid grid-cols-3 gap-4 sm:flex sm:flex-col md:grid-cols-1">
           <div>
-            <a class="h-full" href="/get-started/overview/">
+            <a class="h-full" href="/guides/">
               <div
                 class="flex h-full flex-col gap-2 rounded border border-gray-light-100 bg-white p-4 drop-shadow-sm hover:border-gray-light-200 hover:drop-shadow-lg dark:border-gray-dark-400 dark:bg-gray-dark-200 hover:dark:border-gray-dark">
                 <div class="flex items-center gap-4">
@@ -57,8 +57,7 @@
                   </div>
                 </div>
                 <div class="leading-snug text-gray-light-500 dark:text-gray-dark-700">
-                  Learn the basics and benefits of containerizing your
-                  application.
+                  Get started and learn how Docker can optimize your development workflows
                 </div>
               </div>
             </a>