Skip to content

[Registrar] Expand 7 existing docs pages with troubleshooting and FAQ content#30580

Open
travisgahn wants to merge 1 commit intocloudflare:productionfrom
travisgahn:tgahn/registrar-docs-modifications
Open

[Registrar] Expand 7 existing docs pages with troubleshooting and FAQ content#30580
travisgahn wants to merge 1 commit intocloudflare:productionfrom
travisgahn:tgahn/registrar-docs-modifications

Conversation

@travisgahn
Copy link
Copy Markdown
Contributor

Summary

Expands 7 existing Registrar documentation pages with troubleshooting guidance, edge case coverage, and FAQ additions. This is the second PR from the April 2026 support case gap analysis (companion to #30579 which adds 5 new pages).

Tracked in SPM-3500.

Changes

File What was added Est. deflection
troubleshooting.mdx GoDaddy, Wix, Squarespace, Namecheap transfer-in sections; "registrar says unlocked but CF says locked" guidance ~15 cases/mo
renew-domains.mdx Auto-renewal failure troubleshooting (authorization failed, 404 renewal links, failure timeline table, billing page mismatch) ~10 cases/mo
inter-account-transfer.mdx "Cannot be moved" error checklist, inaccessible source account guidance, third-party platform domains, NS mismatch after transfer ~18 cases/mo
domain-management.mdx Deletion troubleshooting (.uk limitation, 404 errors, token delivery, admin locks) ~12 cases/mo
transfer-domain-to-cloudflare.mdx Auth code troubleshooting (whitespace, expiry, special chars, .ca codes, "transfer conditions not met" checklist) ~10 cases/mo
whois-redaction.mdx Clarification that redaction is free/automatic/default, verification steps, .us exception note ~3 cases/mo
faq.mdx 6 new Q&As: failed registration refunds, double charges, domain name changes, TLD pricing, ownership letters, third-party platform registrations ~20 cases/mo

Total estimated deflection from this PR: ~88 cases/month

Context

Combined with PR #30579 (5 new pages), these two PRs address an estimated 190-220 out of ~350 monthly Registrar support cases (54-63% deflection potential).

The top gaps addressed in this PR:

  • Inter-account transfer edge cases (5% of cases) — customers hit "cannot be moved" errors or have no access to the source account
  • Auto-renewal failures (3%) — "authorization failed" with no troubleshooting path
  • Registrar-specific transfer issues (4%) — Wix/Squarespace/GoDaddy have platform-specific behaviors not documented
  • Domain deletion failures (3%) — .uk limitation, 404 errors not explained
  • Auth code rejection (3%) — no troubleshooting for the most common transfer-in error

Style compliance

  • Uses existing Starlight admonition syntax (:::note, :::caution)
  • DashButton component used for dashboard links
  • No contractions, active voice, "select" not "click"
  • Internal links use relative paths without file extensions
  • Tables use Markdown syntax, no HTML
  • Sequential heading levels (H2 → H3 → H4)

…ontent

Modifications driven by April 2026 support case gap analysis (SPM-3500):

- troubleshooting.mdx: Add GoDaddy/Wix/Squarespace/Namecheap transfer-in sections
- renew-domains.mdx: Add auto-renewal failure troubleshooting and timeline table
- inter-account-transfer.mdx: Add edge cases (inaccessible account, error messages, third-party platforms, NS mismatch)
- domain-management.mdx: Expand deletion troubleshooting (.uk limitation, 404 errors, token issues)
- transfer-domain-to-cloudflare.mdx: Add auth code troubleshooting and transfer conditions checklist
- whois-redaction.mdx: Clarify that redaction is free and automatic with verification steps
- faq.mdx: Add 6 new Q&As (failed registration refunds, double charges, domain name changes, pricing, ownership letters, third-party platforms)
@travisgahn travisgahn requested review from a team and dcpena as code owners May 4, 2026 22:20
@github-actions github-actions Bot added product:registrar Related to Registrar product size/m labels May 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:registrar Related to Registrar product size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants