Skip to content

docs: restore /docker-for-windows/troubleshoot/ alias - #26025

Open
sunm2n wants to merge 1 commit into
docker:mainfrom
sunm2n:docs-restore-dfw-troubleshoot-alias
Open

docs: restore /docker-for-windows/troubleshoot/ alias#26025
sunm2n wants to merge 1 commit into
docker:mainfrom
sunm2n:docs-restore-dfw-troubleshoot-alias

Conversation

@sunm2n

@sunm2n sunm2n commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

Description

/docker-for-windows/troubleshoot/ currently returns a 404. This restores
the alias on the Docker Desktop troubleshoot page.

That alias was removed deliberately in #25115 ("redirect tidy"), along with
seven others on the same page, as old and unused based on traffic analysis.
I'm proposing to restore one of them because there's a live inbound link
that traffic data wouldn't have shown as a working path:

VS Code's dev container tips and tricks page
links to https://docs.docker.com/docker-for-windows/troubleshoot/#volumes.
Readers following that link land on a 404, which is how #26020 was reported.

Scope: only /docker-for-windows/troubleshoot/. The other seven aliases
removed in #25115 also 404 today, but I didn't find inbound links for them,
so I left them alone. Happy to restore more if you'd prefer.

On the anchor: #volumes no longer resolves — that content moved to the
troubleshoot topics page. The alias lands readers on the troubleshoot
overview, which links through to it. Still better than a 404.

Related issues or tickets

Fixes #26020

Reviews

  • Technical review
  • Editorial review
  • Product review

The alias was removed in docker#25115 along with seven others on this page, as
old and unused based on traffic analysis. It still receives inbound
traffic that the analysis would not have shown as a working path: the VS
Code documentation links to /docker-for-windows/troubleshoot/#volumes,
and readers following that link get a 404.

Restore only this one alias. The other seven removed in docker#25115 also 404,
but no inbound links were found for them.

Signed-off-by: Sunmin Lee <134378502+sunm2n@users.noreply.github.com>
@sunm2n
sunm2n requested a review from aevesdocker as a code owner September 7, 2026 01:26
@netlify

netlify Bot commented Sep 7, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit c045010
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a9e12bc44e33d0008336596
😎 Deploy Preview https://deploy-preview-26025--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added the area/desktop Issue affects a desktop edition of Docker. E.g docker for mac label Sep 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/desktop Issue affects a desktop edition of Docker. E.g docker for mac

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[404]: /docker-for-windows/troubleshoot

1 participant