[DOCS-15401] Align GovCloud password reset troubleshooting with the portal UI - #39294
Open
OliviaShoup wants to merge 3 commits into
Open
[DOCS-15401] Align GovCloud password reset troubleshooting with the portal UI#39294OliviaShoup wants to merge 3 commits into
OliviaShoup wants to merge 3 commits into
Conversation
Committed With Claude
Contributor
Preview links (active after the
|
Committed With Claude
OliviaShoup
removed
WORK IN PROGRESS
buraizu
reviewed
Aug 19, 2026
buraizu
left a comment
buraizu
left a comment
Collaborator
There was a problem hiding this comment.
Looks good overall, but left a few suggestions and questions
| Click **Forgot Password** and follow the process with your full username (with the `.ddgov.support` suffix). If you still do not receive the email, add `ddog-gov.com` to your email allowlist. | ||
| Click **Forgot Your Password?** to open the **Reset Your Password** page, then enter your full username, including the `.ddgov.support` suffix, in **Enter your username**. If you still do not receive the email, add `ddog-gov.com` to your email allowlist. | ||
|
|
||
| If you do not know your username, click **Forgot your username?**, then click **Use Your Email Address**. This control takes you out of the GovCloud support portal and opens Salesforce Identity. That page is also titled **Reset Your Password**, but its **Enter your email address** field takes your work email address, not your `.ddgov.support` username. |
Collaborator
There was a problem hiding this comment.
The new paragraph is about not knowing your username, not about a password-reset email that never arrived, but it's nested under the Password reset not received heading. Should this be moved, or given its own heading?
Also, **Forgot your username?** capitalizes differently than the sibling label **Forgot Your Password?** used at lines 124 and 130 in this same PR. Could you please confirm if this is the exact casing shown in the UI?
| ### Password reset not received | ||
|
|
||
| Click **Forgot Password** and follow the process with your full username (with the `.ddgov.support` suffix). If you still do not receive the email, add `ddog-gov.com` to your email allowlist. | ||
| Click **Forgot Your Password?** to open the **Reset Your Password** page, then enter your full username, including the `.ddgov.support` suffix, in **Enter your username**. If you still do not receive the email, add `ddog-gov.com` to your email allowlist. |
Collaborator
There was a problem hiding this comment.
**Enter your username** is a bare bolded phrase here, which reads ambiguously as either an instruction or a field name. The parallel phrase later in the same section (its **Enter your email address** field) qualifies it with "field," so this line is inconsistent.
Suggested change
| Click **Forgot Your Password?** to open the **Reset Your Password** page, then enter your full username, including the `.ddgov.support` suffix, in **Enter your username**. If you still do not receive the email, add `ddog-gov.com` to your email allowlist. | |
| Click **Forgot Your Password?** to open the **Reset Your Password** page, then enter your full username, including the `.ddgov.support` suffix, in the **Enter your username** field. If you still do not receive the email, add `ddog-gov.com` to your email allowlist. |
| ### Registration error | ||
|
|
||
| Your account may already exist. Click **Forgot Password** and enter your full username, including the `.ddgov.support` suffix (for example, `[name]@[domain].ddgov.support`). If you are still unable to access your account, contact `support@ddog-gov.com`. | ||
| Your account may already exist. Click **Forgot Your Password?**, then enter your full username, including the `.ddgov.support` suffix (for example, `[name]@[domain].ddgov.support`), in **Enter your username**. If you are still unable to access your account, contact `support@ddog-gov.com`. |
Collaborator
There was a problem hiding this comment.
Suggested change
| Your account may already exist. Click **Forgot Your Password?**, then enter your full username, including the `.ddgov.support` suffix (for example, `[name]@[domain].ddgov.support`), in **Enter your username**. If you are still unable to access your account, contact `support@ddog-gov.com`. | |
| Your account may already exist. Click **Forgot Your Password?**, then enter your full username, including the `.ddgov.support` suffix (for example, `[name]@[domain].ddgov.support`), in the **Enter your username** field. If you are still unable to access your account, contact `support@ddog-gov.com`. |
| Click **Forgot Password** and follow the process with your full username (with the `.ddgov.support` suffix). If you still do not receive the email, add `ddog-gov.com` to your email allowlist. | ||
| Click **Forgot Your Password?** to open the **Reset Your Password** page, then enter your full username, including the `.ddgov.support` suffix, in **Enter your username**. If you still do not receive the email, add `ddog-gov.com` to your email allowlist. | ||
|
|
||
| If you do not know your username, click **Forgot your username?**, then click **Use Your Email Address**. This control takes you out of the GovCloud support portal and opens Salesforce Identity. That page is also titled **Reset Your Password**, but its **Enter your email address** field takes your work email address, not your `.ddgov.support` username. |
Collaborator
There was a problem hiding this comment.
"Control" is jargon-adjacent for a clickable button/link. Plain language is clearer for readers.
Suggested change
| If you do not know your username, click **Forgot your username?**, then click **Use Your Email Address**. This control takes you out of the GovCloud support portal and opens Salesforce Identity. That page is also titled **Reset Your Password**, but its **Enter your email address** field takes your work email address, not your `.ddgov.support` username. | |
| If you do not know your username, click **Forgot your username?**, then click **Use Your Email Address**. This link takes you out of the GovCloud support portal and opens Salesforce Identity. That page is also titled **Reset Your Password**, but its **Enter your email address** field takes your work email address, not your `.ddgov.support` username. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What does this PR do? What is the motivation?
Fixes DOCS-15401
Updating email troubleshooting page to match GovCloud's UI process/labels.
Merge readiness
AI assistance
Claude Code was used to draft the revised troubleshooting copy from the outline on the ticket, and to check it against the surrounding page style.
Additional notes