docs/content/guides/_index.md at bot/sync-cli-docs

mirror of https://github.com/docker/docs.git synced 2026-10-25 06:09:46 +03:00

Files

David Karlsson f02e2a5633 Revamp the guides section: taxonomy, single-page structure, and new landing/filter UX (#25338 )

## 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>

2026-07-01 10:47:10 +02:00

767 B

Raw Permalink Blame History

title, linkTitle, description, keywords, params, layout, aliases

title

linkTitle

description

keywords

params

layout

aliases

Docker guides

Guides

Step-by-step tutorials, organized by what you're trying to do.

docker, guides, tutorials, learning paths, getting started

icon
book-open

landing

/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 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 repository.

767 B Raw Permalink Blame History

767 B

Raw Permalink Blame History