Skip to content

[Registrar] Add troubleshooting section to transfer page - #29285

Merged
marciocloudflare merged 3 commits into
cloudflare:productionfrom
mhsu:mhsu/registrar-transfers-update4
Apr 21, 2026
Merged

[Registrar] Add troubleshooting section to transfer page#29285
marciocloudflare merged 3 commits into
cloudflare:productionfrom
mhsu:mhsu/registrar-transfers-update4

Conversation

@mhsu

@mhsu mhsu commented Mar 24, 2026

Copy link
Copy Markdown
Contributor

Adds a 'Having issues?' section to the bottom of the transfer guide with direct links to the most common troubleshooting scenarios. Previously, the 'Troubleshooting' page was only text-linked from this main transfers page and not easy to discover. This changes that.

  • Adds a named 'Having issues?' section with links to 6 common issues (locked domain, invalid auth code, transfer rejected, etc.)
  • Catch-all link to the full troubleshooting page at the bottom

@mhsu
mhsu requested a review from dcpena as a code owner March 24, 2026 16:06
@mhsu
mhsu requested a review from a team March 24, 2026 16:06
@github-actions github-actions Bot added product:registrar Related to Registrar product size/m labels Mar 24, 2026

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.

This information is captured in the note that's in this partial file. If you want to see the exact note, it's the second note on this page.

https://github.com/cloudflare/cloudflare-docs/pull/29285/changes#diff-74ed41e19e66517fe60d2f24bfedf5f1ff6013eb336240ab99f515fe471010ddR26

@github-actions

github-actions Bot commented Apr 9, 2026

Copy link
Copy Markdown
Contributor

Hey there, we've marked this pull request as stale because there's no recent activity on it. This label helps us identify PRs that might need updates (or to be closed out by our team if no longer relevant).

@github-actions github-actions Bot added the stale label Apr 9, 2026
@mhsu
mhsu force-pushed the mhsu/registrar-transfers-update4 branch from e89914c to 334eaee Compare April 20, 2026 17:11

@marciocloudflare marciocloudflare 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.

Style and structural review — 2 issues found across 2 files.

The main issue is a merge conflict with production: the "Email verification required" section was added to troubleshooting.mdx by PR #29782 on 2026-04-15 while this PR was sitting stale. Rebasing onto production will drop the duplicate and surface whether anything else needs updating.

Comment thread src/content/docs/registrar/troubleshooting.mdx Outdated
@@ -198,6 +198,17 @@ The process for transferring domains in bulk is the same as transferring a singl

---

If your transfer is stuck or failing, refer to [Troubleshoot failed domain transfers](/registrar/troubleshooting/).
## Having issues?

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.

[medium] Heading style. ## Having issues? uses a gerund ("Having") and ends in a question — the docs style guide says: "Never use gerund phrases, questions, or calls to action as titles or subtitles."

Suggested rename: ## Common transfer issues (noun phrase) or ## Troubleshoot common issues (imperative). Either conforms to the rule and keeps the section's intent clear.

Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
@mhsu
mhsu force-pushed the mhsu/registrar-transfers-update4 branch from 334eaee to 9213067 Compare April 20, 2026 20:23
@mhsu

mhsu commented Apr 20, 2026

Copy link
Copy Markdown
Contributor Author

All feedback addressed:

  • Rebased onto production
  • Removed the duplicate ## Email verification required section from troubleshooting.mdx
  • Renamed ## Having issues? to ## Common transfer issues per style guide

@github-actions github-actions Bot removed the stale label Apr 21, 2026
@marciocloudflare
marciocloudflare enabled auto-merge (squash) April 21, 2026 07:32
@marciocloudflare
marciocloudflare merged commit 7265f1b into cloudflare:production Apr 21, 2026
8 checks passed
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.

4 participants