Revamp the guides section: taxonomy, single-page structure, and new landing/filter UX

assets/css/utilities.css

@@ -208,6 +208,33 @@
     }
   }
 }
+@utility scrollbar-hover {
+  /* Firefox: hide the thumb until hover */
+  scrollbar-width: thin;
+  scrollbar-color: transparent transparent;
+  &:hover {
+    scrollbar-color: var(--color-gray-400) transparent;
+  }
+  .dark &:hover {
+    scrollbar-color: var(--color-gray-600) transparent;
+  }
+  /* WebKit: reserve the track, reveal the thumb only on hover */
+  &::-webkit-scrollbar {
+    width: 8px;
+    height: 8px;
+  }
+  &::-webkit-scrollbar-thumb {
+    border-radius: 9999px;
+    background-color: transparent;
+  }
+  &:hover::-webkit-scrollbar-thumb {
+    background-color: var(--color-gray-400);
+  }
+  .dark &:hover::-webkit-scrollbar-thumb {
+    background-color: var(--color-gray-600);
+  }
+}
+
 @utility chip {
   @apply border-divider-light dark:border-divider-dark inline-flex items-center gap-1 rounded-full border bg-gray-100 px-2 text-sm text-gray-800 select-none dark:bg-gray-700 dark:text-gray-200;
 }
@@ -217,7 +244,17 @@
 }
 
 @utility breadcrumbs {
-  font-size: 90%;
+  /* Absolute size so breadcrumbs render identically inside and outside prose */
+  font-size: calc(var(--text-base) * 0.9);
+}
+
+/* Guides landing: collapse section spacing into a flat list while filtering.
+   Grouped spacing is the static default; this only applies once the page is
+   being filtered, so it never affects first paint (no layout jank). */
+.guides-flat > section {
+  border-top-width: 0 !important;
+  padding-top: 0 !important;
+  padding-bottom: 0 !important;
 }
 
 @utility topbar-button {

content/guides/_index.md

@@ -1,21 +1,25 @@
 ---
 title: Docker guides
 linkTitle: Guides
-description: Explore the Docker guides
+description: Step-by-step tutorials, organized by what you're trying to do.
 keywords: docker, guides, tutorials, learning paths, getting started
 params:
   icon: book-open
 layout: landing
 aliases:
   - /guides/language/
   - /language/
+  - /guides/dhi-from-doi/
+  - /guides/dhi-from-wolfi/
+  - /guides/dhi-go-example/
+  - /guides/dhi-nodejs-example/
+  - /guides/dhi-python-example/
+  - /guides/lab-docker-for-ai-redirect/
   - /learning-paths/
 ---
 
-Explore our collection of guides to learn how Docker can optimize your
-development workflows and how to use it with specific languages, frameworks, or
-technologies.
+Explore guides to learn how Docker can optimize your development workflows and
+how to use it with specific languages, frameworks, or technologies.
 
 Can't find the guide you're looking for? Open an issue on the
-[docker/docs](https://github.com/docker/docs/issues/new) repository to let us
-know.
+[docker/docs](https://github.com/docker/docs/issues/new) repository.