mirror of
https://github.com/docker/docs.git
synced 2026-10-23 18:09:02 +03:00
f02e2a5633
## What A full revamp of the `/guides` section — taxonomy, structure, and UX. Preview: https://deploy-preview-25338--docsdocker.netlify.app/guides/ ### Taxonomy & structure - Replaces the sprawling 24-tag set with a focused 9-tag taxonomy aligned to use case / SDLC: **Languages & frameworks, AI, Testing, CI/CD, Security, Databases, Deployment, Admin, Hands-on labs**. - Removes the languages taxonomy entirely (`data/languages.yaml` and all `languages:` front matter). - Collapses all multi-page guide series into single pages, with aliases so old sub-page URLs continue to resolve. - Deletes redirect-only shim pages and flattens directory-wrapped single pages. ### Landing page (`/guides/`) - A clean index: hero, then category sections listing each guide as a plain **title / summary** row. - **Browse rail** (sticky, left): click a topic to filter the page to just that topic's guides; "All guides" resets. A count + Clear bar appears while filtering. - **Text filter**: instant client-side search over title, summary, and tags. Topic filter and text search are mutually exclusive and share the same flat-list view. - No more "Featured guides" section. ### Guide content pages - Removes the left sidebar for the guides section (mobile drawer kept). - Centered reading column (`92ch`) with the TOC taking the remaining width. - Summary rendered as a lead paragraph under the h1. - TOC scrollbar auto-hides until hover; breadcrumbs render at a consistent size inside and outside `prose`. ## Notes - Deep full-text search across guide bodies is still handled by the existing site-wide Pagefind (⌘K); the landing filter is the fast metadata-narrowing surface. - `series.html` is retained — it's still used by `get-started` pages. ## Validation - Site builds clean locally (Hugo dev server, no errors / broken refs). - All collapsed sub-page URLs redirect via aliases. ## Follow-ups - Prune guides that we no longer need/want - Tighten the guides that span too many concepts (e.g. language guides; remove cicd/deploy/sscs) 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
27 lines
851 B
HTML
27 lines
851 B
HTML
{{ partial "breadcrumbs.html" . }}
|
|
<h1 data-pagefind-weight="10">{{ .Title | safeHTML }}</h1>
|
|
{{- if and (eq .Type "guides") .Params.summary }}
|
|
<p class="mt-0 text-lg text-gray-500 dark:text-gray-400">
|
|
{{ .Params.summary }}
|
|
</p>
|
|
{{- end }}
|
|
<div class="hidden lg:block">
|
|
{{ partialCached "md-dropdown.html" "-" "-" }}
|
|
</div>
|
|
<div class="block lg:hidden">
|
|
{{ partialCached "pagemeta.html" . . }}
|
|
<hr />
|
|
</div>
|
|
{{ .Content }}
|
|
{{- if and (eq .Type "guides") (not .IsSection) (ne .CurrentSection .FirstSection) -}}
|
|
{{- with .PrevInSection -}}
|
|
<div class="not-prose col-start-2 my-4">
|
|
<a
|
|
href="{{ .Permalink }}"
|
|
class="cursor-pointer rounded-sm bg-blue-500 px-4 py-2 text-white hover:bg-blue-400 dark:bg-blue-800 dark:hover:bg-blue-700"
|
|
>{{ .Title }} »</a
|
|
>
|
|
</div>
|
|
{{- end -}}
|
|
{{- end -}}
|