Skip to content

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

Merged
aevesdocker merged 1 commit into
docker:mainfrom
sunm2n:docs-restore-dfw-troubleshoot-alias
Sep 7, 2026
Merged

aevesdocker merged 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

@aevesdocker aevesdocker left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks

@aevesdocker
aevesdocker merged commit 571f478 into docker:main Sep 7, 2026
16 checks passed
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

2 participants