[Support Feedback] Improve error handling, Wrangler debugging, and KV troubleshooting (Workers)

[dmmulroy]

Summary

Adds troubleshooting guidance for common Workers platform support topics, based on an audit of active support macros.

Changes

• 1101 errors: Add try/catch example and explain common causes of Worker runtime errors
• Wrangler CLI: Expand debugging and installation troubleshooting guidance
• KV troubleshooting: Add FAQ entries for common KV issues (eventual consistency, missing keys, binding errors)
• Image Resizing via URL: Clarify URL format requirements and common misconfiguration

Context

These changes are driven by recurring support cases. If you want to see the underlying support data (macro frequency, case volume by topic), reach out to @dmmulroy internally.

[elithrar]

/bonk review this and suggest any fixes

[ask-bonk]

Solid troubleshooting additions. Posted 3 inline suggestions — 1 medium, 2 low severity.

• MEDIUM: transform-via-url.mdx — H3 headings (### Examples, ### When to use URL format versus Workers) appear before any H2 in the page body (lines 30, 50). This skips a heading level (title is H1, then jumps to H3). These should be H2, or a parent H2 section should wrap them.
• LOW: install-and-update.mdx line 64 — bare wrangler --version inconsistent with existing section above which uses npx wrangler --version. Since the page recommends local installation and running via npx, the troubleshooting section should match.
• LOW: install-and-update.mdx lines 71, 77 — bare wrangler deploy commands, same consistency concern with npx.

[ask-bonk]

Review submitted. Here's a summary of what I posted:

3 inline suggestions on PR #28996:

1. MEDIUM — transform-via-url.mdx lines 30-50: The new ### Examples and ### When to use URL format versus Workers headings are H3s that appear before any H2 in the page body, skipping a heading level. Suggested changing both to H2.

2. LOW — install-and-update.mdx line 64: The troubleshooting section uses bare wrangler --version while the existing "Check your Wrangler version" section above uses npx wrangler --version. Suggested npx wrangler --version for consistency.

3. LOW — install-and-update.mdx line 86: Same npx consistency issue in the "Information to provide" checklist.

Everything else looked good — all internal links resolve correctly, code examples use the right components (TypeScriptExample), no contractions, no MDX syntax issues, heading hierarchy in the other files is fine, and the KV FAQ and errors.mdx content is accurate and well-structured.

github run