Skip to content

dhi: refresh troubleshoot & debug#24658

Merged
craig-osterhout merged 2 commits intodocker:mainfrom
craig-osterhout:engdocs-3222-4
Apr 8, 2026
Merged

dhi: refresh troubleshoot & debug#24658
craig-osterhout merged 2 commits intodocker:mainfrom
craig-osterhout:engdocs-3222-4

Conversation

@craig-osterhout
Copy link
Copy Markdown
Contributor

@craig-osterhout craig-osterhout commented Apr 7, 2026

Description

Merged how-to/debug into troubleshoot to reduce left nav sprawl. Kept troubleshoot at top-level to align with other manuals.

https://deploy-preview-24658--docsdocker.netlify.app/dhi/troubleshoot/

Related issues or tickets

Reviews

  • Editorial review

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
@craig-osterhout craig-osterhout requested a review from a team April 7, 2026 20:19
@craig-osterhout craig-osterhout added status/review Pull requests that are ready for review area/dhi labels Apr 7, 2026
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 7, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 2dd28bf
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/69d6735ea35a720008a81f6c
😎 Deploy Preview https://deploy-preview-24658--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.

@craig-osterhout
Copy link
Copy Markdown
Contributor Author

/review

Copy link
Copy Markdown
Contributor

@docker-agent docker-agent bot left a comment

Choose a reason for hiding this comment

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

Assessment: 🟢 APPROVE

This PR successfully consolidates the debug.md how-to page into troubleshoot.md to reduce left navigation sprawl. The changes are well-executed:

Proper redirect configured: The aliases: ["/dhi/how-to/debug/"] entry in troubleshoot.md front matter ensures old links redirect correctly

All cross-references updated: Links in dhi-backstage.md and dhi-openshift.md correctly point to /dhi/troubleshoot/#general-debugging

Anchor targets verified: The ## General debugging heading exists and will generate the expected #general-debugging anchor

Content consistency: Front matter and body text align correctly (discovery → governance)

Proper heading hierarchy: Debug content correctly nested under "General debugging" section

No issues found. The merge preserves all content and maintains proper documentation structure.

Copy link
Copy Markdown
Contributor

@aevesdocker aevesdocker left a comment

Choose a reason for hiding this comment

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

1 non-blocking pickiest of picky nits (that I'm amazed I (of all people) spotted)

Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
@craig-osterhout craig-osterhout merged commit fa88f5d into docker:main Apr 8, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/dhi status/review Pull requests that are ready for review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants