Skip to content

Update email preferences instructions with warning#43249

Open
Kenshiro-sama wants to merge 1 commit intogithub:mainfrom
Kenshiro-sama:patch-1
Open

Update email preferences instructions with warning#43249
Kenshiro-sama wants to merge 1 commit intogithub:mainfrom
Kenshiro-sama:patch-1

Conversation

@Kenshiro-sama
Copy link

@Kenshiro-sama Kenshiro-sama commented Mar 6, 2026

Added a warning about removing old email addresses affecting commit associations.

Why:

Users may remove an old email address from their account without realizing that commits made with that email may no longer be associated with their profile. When this happens, those commits may stop appearing in the user's contribution graph.
This behavior is not currently mentioned in the documentation for changing the primary email address, which can lead to confusion or accidental loss of visible contribution history.

Closes: N/A

What's being changed (if available, include any code snippets, screenshots, or gifs):

This pull request adds a warning note before the step that instructs users to remove an old email address.
The warning explains that removing an email address used in previous commits may cause those commits to no longer be associated with the user’s account or appear in their contribution graph. It also advises users to ensure their commits are linked to another verified email before removing the address.

Check off the following:

  • A subject matter expert (SME) has reviewed the technical accuracy of the content in this PR. In most cases, the author can be the SME. Open source contributions may require an SME review from GitHub staff.
  • The changes in this PR meet the docs fundamentals that are required for all content.
  • All CI checks are passing and the changes look good in the review environment.

Added a warning about removing old email addresses affecting commit associations.
@github-actions github-actions bot added the triage Do not begin working on this issue until triaged by the team label Mar 6, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Mar 6, 2026

How to review these changes 👓

Thank you for your contribution. To review these changes, choose one of the following options:

A Hubber will need to deploy your changes internally to review.

Table of review links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source Review Production What Changed
account-and-profile/how-tos/email-preferences/changing-your-primary-email-address.md fpt
ghec
ghes@ 3.20 3.19 3.18 3.17 3.16 3.15 3.14
fpt
ghec
ghes@ 3.20 3.19 3.18 3.17 3.16 3.15 3.14

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

@Sharra-writes
Copy link
Contributor

@Kenshiro-sama Thanks for opening a PR! I don't have any major objections to having this warning here, since I know people can sometimes get intense about their contribution graphs, but I'm checking in with the rest of the team to make sure no one else has an objection that didn't occur to me.

@Sharra-writes Sharra-writes added content This issue or pull request belongs to the Docs Content team account-and-profile Content relating to account and profile and removed triage Do not begin working on this issue until triaged by the team labels Mar 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

account-and-profile Content relating to account and profile content This issue or pull request belongs to the Docs Content team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants