Skip to content

Commit 522b727

Browse files
dvdksnclaude
andcommitted
guides: Phase 2 — Vercel KB landing page + clean content layout
Landing page (layouts/guides/landing.html): - Remove sidebar filter (checkboxes, language buttons) - Hero section: guide count, large "Guides." heading, description - Sticky left "Jump to" nav with numbered categories and counts - Sections per tag with 2-column card grid (title | summary) - Scrollspy via IntersectionObserver highlights active section - No Alpine.js filtering — browse by scrolling/jumping Content pages (layouts/guides/list.html, new): - Clean left sidebar: just mainnav, no guide-specific metadata - Slightly wider article (max-w-5xl) - TOC stays in right column via baseof.html default Other: - data/tags.yaml: add description to each tag (shown under section heading) - layouts/_partials/guide-languages.html: deleted (languages removed in Phase 1) - layouts/_partials/sidebar/guides.html: simplify (remove stepper, resource_links, languages — now just title, summary, tags, time, back link) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 00819cd commit 522b727

6 files changed

Lines changed: 112 additions & 303 deletions

File tree

content/guides/_index.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Docker guides
33
linkTitle: Guides
4-
description: Explore the Docker guides
4+
description: Step-by-step tutorials, organized by what you're trying to do.
55
keywords: docker, guides, tutorials, learning paths, getting started
66
params:
77
icon: book-open
@@ -18,10 +18,8 @@ aliases:
1818
- /learning-paths/
1919
---
2020

21-
Explore our collection of guides to learn how Docker can optimize your
22-
development workflows and how to use it with specific languages, frameworks, or
23-
technologies.
21+
Explore guides to learn how Docker can optimize your development workflows and
22+
how to use it with specific languages, frameworks, or technologies.
2423

2524
Can't find the guide you're looking for? Open an issue on the
26-
[docker/docs](https://github.com/docker/docs/issues/new) repository to let us
27-
know.
25+
[docker/docs](https://github.com/docker/docs/issues/new) repository.

data/tags.yaml

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,21 @@
11
admin:
22
title: Admin
3+
description: Manage Docker organizations, users, and access controls.
34
ai:
45
title: AI
6+
description: Build AI-powered apps, agents, and integrations with Docker.
57
cicd:
68
title: CI/CD
9+
description: Automate builds, tests, and deployments in your pipelines.
710
databases:
811
title: Databases
12+
description: Run and connect to databases in containers.
913
deployment:
1014
title: Deployment
15+
description: Deploy containerized apps to Kubernetes and other platforms.
1116
security:
1217
title: Security
18+
description: Harden images, scan vulnerabilities, and secure your supply chain.
1319
testing:
1420
title: Testing
21+
description: Integration testing with real databases and services.

layouts/_partials/guide-languages.html

Lines changed: 0 additions & 15 deletions
This file was deleted.

layouts/_partials/sidebar/guides.html

Lines changed: 7 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -3,37 +3,17 @@
33
<div class="font-semibold">
44
<a href="{{ $guide.Permalink }}">{{ $guide.Title }}</a>
55
</div>
6-
<div>{{ $guide.Summary }}</div>
7-
<div class="space-y-4">
8-
<div class="flex flex-wrap gap-2">
9-
{{- with $guide.Params.languages }}
10-
{{ partial "guide-languages.html" . }}
11-
{{- end }}
12-
{{- with $guide.Params.tags }}
13-
{{ partial "guide-tags.html" . }}
14-
{{- end }}
15-
</div>
6+
<div class="text-sm text-gray-500 dark:text-gray-400">{{ $guide.Summary }}</div>
7+
<div class="flex flex-wrap gap-2">
8+
{{- with $guide.Params.tags }}
9+
{{ partial "guide-tags.html" . }}
10+
{{- end }}
1611
{{- with $guide.Params.time }}
17-
<div class="flex gap-2 text-gray-400 dark:text-gray-400">
18-
<span class="icon-svg"
19-
>{{ partialCached "icon" "clock" "clock" }}</span
20-
>
12+
<div class="flex gap-1.5 text-sm text-gray-400 dark:text-gray-400">
13+
<span class="icon-svg">{{ partialCached "icon" "clock" "clock" }}</span>
2114
<span>{{ . }}</span>
2215
</div>
2316
{{- end -}}
2417
</div>
25-
{{- if gt (len $guide.Pages) 0 }}
26-
{{- partial "guides-stepper.html" . }}
27-
{{- end }}
28-
{{- with $guide.Params.resource_links }}
29-
<div class="space-y-2">
30-
<p>Resources:</p>
31-
<ul class="ml-4 space-y-2">
32-
{{- range . }}
33-
<li><a href="{{ .url }}" class="link">{{ .title }}</a></li>
34-
{{- end }}
35-
</ul>
36-
</div>
37-
{{- end }}
3818
<a href="/guides/" class="link mt-2">&laquo; Back to all guides</a>
3919
</div>

0 commit comments

Comments
 (0)