Skip to content

[DOCS-15401] Align GovCloud password reset troubleshooting with the portal UI - #39294

Open
OliviaShoup wants to merge 7 commits into
masterfrom
olivia/govcloud-password-reset-ui
Open

[DOCS-15401] Align GovCloud password reset troubleshooting with the portal UI#39294
OliviaShoup wants to merge 7 commits into
masterfrom
olivia/govcloud-password-reset-ui

Conversation

@OliviaShoup

@OliviaShoup OliviaShoup commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

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

  • Ready for merge

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

@OliviaShoup
OliviaShoup requested a review from a team as a code owner August 18, 2026 19:45
@OliviaShoup OliviaShoup added the WORK IN PROGRESS No review needed, it's a wip ;) label Aug 18, 2026
@github-actions github-actions Bot added the Guide Content impacting a guide label Aug 18, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

@OliviaShoup OliviaShoup removed WORK IN PROGRESS No review needed, it's a wip ;) Guide Content impacting a guide labels Aug 19, 2026
@github-actions github-actions Bot added the Guide Content impacting a guide label Aug 19, 2026
@buraizu buraizu self-assigned this Aug 19, 2026

@buraizu buraizu left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

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.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

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?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@buraizu great questions, thank you!

this is the correct capitalization 🥲 i'm glad we double-checked though!

for moving the new paragraph, that makes sense to me. the only UI problem is that you have to click Forgot Your Password? before you can get to Forgot your username?

do you still think we should move it? if yes, i could just add in a sentence/clause to click Forgot Your Password? first

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

@OliviaShoup thanks for following up!

From my perspective, it still makes sense to move it and give it its own heading. The "don't know your username" case and the "Password reset not received" case are different symptoms — someone scanning headings for "I don't know my username" won't land on "not received."

Your fix for the UI order works: just open that paragraph with the click on Forgot Your Password? first, the same way the other paragraph does, so it's self-contained under its own heading. I'll drop a suggested diff in the thread.

### Password reset not received

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.

### Do not know your username

Click **Forgot Your Password?** to open the **Reset Your Password** page, then 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.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

this is much better. thank you, Bryce!

Comment thread hugo/content/en/account_management/guide/manage-your-support-tickets.md Outdated
Comment thread hugo/content/en/account_management/guide/manage-your-support-tickets.md Outdated
Comment thread hugo/content/en/account_management/guide/manage-your-support-tickets.md Outdated
@OliviaShoup
OliviaShoup requested a review from buraizu September 11, 2026 19:07

@buraizu buraizu left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thanks for following up! Left one last suggestion to make the new content easier to parse — currently, that paragraph has quite a lot of bold text:
username-reset

I suggested a couple of potential resolutions, but I'll leave it for you to decide which one to use. I'll approve for now so this can be merged.

Comment thread hugo/content/en/account_management/guide/manage-your-support-tickets.md Outdated
…ickets.md

Co-authored-by: Bryce Eadie <bryce.eadie@datadoghq.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Guide Content impacting a guide

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants