Commit f02e2a5
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>1 parent ef2165d commit f02e2a5
302 files changed
Lines changed: 22994 additions & 24569 deletions
File tree
- assets/css
- content
- guides
- admin-set-up
- admin-user-management
- angular
- bun
- cpp
- deno
- docker-build-cloud
- docker-compose
- docker-scout
- dotnet
- frameworks/laravel
- genai-claude-code-mcp
- genai-leveraging-rag
- genai-pdf-bot
- genai-video-bot
- github-sonarqube-sandbox
- go-prometheus-monitoring
- golang
- java
- nextjs
- nodejs
- php
- postgresql
- python
- rag-ollama
- reactjs
- ros2
- ruby
- rust
- r
- testcontainers-cloud
- testcontainers-dotnet-aspnet-core
- testcontainers-dotnet-getting-started
- testcontainers-go-getting-started
- testcontainers-java-aws-localstack
- testcontainers-java-getting-started
- testcontainers-java-jooq-flyway
- testcontainers-java-keycloak-spring-boot
- testcontainers-java-lifecycle
- testcontainers-java-micronaut-kafka
- testcontainers-java-micronaut-wiremock
- testcontainers-java-mockserver
- testcontainers-java-quarkus
- testcontainers-java-replace-h2
- testcontainers-java-service-configuration
- testcontainers-java-spring-boot-kafka
- testcontainers-java-spring-boot-rest-api
- testcontainers-java-wiremock
- testcontainers-nodejs-getting-started
- testcontainers-python-getting-started
- vuejs
- manuals/build/metadata/attestations
- data
- layouts
- _partials
- sidebar
- guides
- redirect
Some content is hidden
Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
208 | 208 | | |
209 | 209 | | |
210 | 210 | | |
| 211 | + | |
| 212 | + | |
| 213 | + | |
| 214 | + | |
| 215 | + | |
| 216 | + | |
| 217 | + | |
| 218 | + | |
| 219 | + | |
| 220 | + | |
| 221 | + | |
| 222 | + | |
| 223 | + | |
| 224 | + | |
| 225 | + | |
| 226 | + | |
| 227 | + | |
| 228 | + | |
| 229 | + | |
| 230 | + | |
| 231 | + | |
| 232 | + | |
| 233 | + | |
| 234 | + | |
| 235 | + | |
| 236 | + | |
| 237 | + | |
211 | 238 | | |
212 | 239 | | |
213 | 240 | | |
| |||
217 | 244 | | |
218 | 245 | | |
219 | 246 | | |
220 | | - | |
| 247 | + | |
| 248 | + | |
| 249 | + | |
| 250 | + | |
| 251 | + | |
| 252 | + | |
| 253 | + | |
| 254 | + | |
| 255 | + | |
| 256 | + | |
| 257 | + | |
221 | 258 | | |
222 | 259 | | |
223 | 260 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
4 | | - | |
| 4 | + | |
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
9 | 9 | | |
10 | 10 | | |
11 | 11 | | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
12 | 18 | | |
13 | 19 | | |
14 | 20 | | |
15 | | - | |
16 | | - | |
17 | | - | |
| 21 | + | |
| 22 | + | |
18 | 23 | | |
19 | 24 | | |
20 | | - | |
21 | | - | |
| 25 | + | |
This file was deleted.
This file was deleted.
This file was deleted.
This file was deleted.
0 commit comments