Skip to content

Commit 39e9cf9

Browse files
authored
[EDI] Update "Personalizing your profile" (#57493)
1 parent 7d2059e commit 39e9cf9

File tree

7 files changed

+213
-128
lines changed

7 files changed

+213
-128
lines changed

content/account-and-profile/concepts/about-your-profile.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,11 @@ versions:
1616
topics:
1717
- Profiles
1818
---
19-
You can tell other people a little bit about yourself by writing a bio. Consider including previous places you've worked, projects you've contributed to, or interests you have that other people may like to know about.
19+
You can tell other people a little bit about yourself by writing a bio. With the help of [@mentions](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) and emoji, you can include information about where you currently or have previously worked, what type of work you do, or even what kind of coffee you drink. The bio field is limited to 160 characters.
2020

21-
You can further showcase your current work, interests, expertise, and more by creating a profile README. If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page.
21+
For a longer-form and more prominent way of displaying customized information about yourself, you can create a profile README. If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page.
22+
23+
If you have the activity overview section enabled for your profile and you @mention an organization you're a member of in your profile bio, then that organization will be featured first in your activity overview.
2224

2325
![Screenshot of the profile page for @octocato. In the top-right corner, a profile README greets the viewer and lists information about the user's work.](/assets/images/help/repository/profile-with-readme.png)
2426

content/account-and-profile/get-started/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ versions:
77
ghes: '*'
88
ghec: '*'
99
children:
10+
- /profile
1011
- /personal-dashboard-quickstart
11-
- /personalizing-your-profile
1212
---
1313

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
---
2+
title: Profile
3+
intro: 'Get started with your {% data variables.product.github %} profile.'
4+
versions:
5+
fpt: '*'
6+
ghes: '*'
7+
ghec: '*'
8+
topics:
9+
- Profiles
10+
shortTitle: Profile
11+
---
12+
13+
## About profiles
14+
15+
Your {% data variables.product.github %} profile showcases your work, contributions, and information you choose to share publicly.
16+
17+
{% ifversion fpt or ghec %}
18+
19+
> [!IMPORTANT]
20+
> Any details you add to your public profile will be visible to all {% data variables.product.github %} users, including in regions where local laws, regulations, or cultural norms may pose risks to expressing your identity. We respect everyone’s decision about whether or not to share information about themselves on their {% data variables.product.github %} profile.
21+
22+
{% endif %}
23+
24+
## Key profile elements
25+
26+
Your profile includes these customizable elements:
27+
28+
* **Personal info**: Profile picture, name, bio, and pronouns
29+
* **Status**: Shows your current availability and what you're working on
30+
* **Pinned items**: Repositories and gists you choose to highlight
31+
* **Contribution activity**: Visualizes your work on {% data variables.product.github %}
32+
* **Profile README**: A customizable section at the top of your profile
33+
* **Achievements and badges**: Recognizes your participation in programs or milestones
34+
35+
## Profile visibility
36+
37+
You can control the visibility of specific profile elements or set your entire profile to private.
38+
39+
## Next steps
40+
41+
* For more details about your profile, see [AUTOTITLE](/account-and-profile/concepts/about-your-profile).
42+
* For a general tutorial on personalizing your profile, see [AUTOTITLE](/account-and-profile/tutorials/personalize-your-profile).
43+
* For more specific profile customization, see [AUTOTITLE](/account-and-profile/how-tos/setting-up-and-managing-your-github-profile).
44+
* For reference information, see [AUTOTITLE](/account-and-profile/reference/profile-reference).

content/account-and-profile/reference/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ versions:
77
ghes: '*'
88
ghec: '*'
99
children:
10+
- /profile-reference
1011
- /personal-dashboard
1112
- /permission-levels-for-a-personal-account-repository
1213
- /profile-contributions-reference

content/account-and-profile/get-started/personalizing-your-profile.md renamed to content/account-and-profile/reference/profile-reference.md

Lines changed: 30 additions & 124 deletions
Original file line numberDiff line numberDiff line change
@@ -1,165 +1,67 @@
11
---
2-
title: Personalizing your profile
3-
intro: You can share information about yourself with other users by setting a profile picture and adding a bio to your profile.
4-
redirect_from:
5-
- /articles/adding-a-bio-to-your-profile
6-
- /articles/setting-your-profile-picture
7-
- /articles/how-do-i-set-up-my-profile-picture
8-
- /articles/gravatar-problems
9-
- /articles/how-do-i-set-up-my-avatar
10-
- /articles/personalizing-your-profile
11-
- /github/setting-up-and-managing-your-github-profile/personalizing-your-profile
12-
- /github/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile
13-
- /account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile
2+
title: Profile reference
3+
intro: 'Reference information for your {% data variables.product.github %} profile.'
144
versions:
155
fpt: '*'
166
ghes: '*'
177
ghec: '*'
188
topics:
199
- Profiles
20-
shortTitle: Personalize
10+
shortTitle: Profile reference
2111
---
2212

23-
{% ifversion fpt or ghec %}
24-
> [!NOTE]
25-
> Any details you add to your public profile will be visible to all {% data variables.product.github %} users, including in regions where local laws, regulations, or cultural norms may pose risks to expressing your identity. We respect everyone’s decision about whether or not to share information about themselves on their {% data variables.product.github %} profile.
26-
{% endif %}
27-
28-
## Changing your profile picture
29-
30-
Your profile picture helps identify you across {% data variables.product.github %} in pull requests, comments, contributions pages, and graphs.
31-
32-
When you sign up for an account, {% data variables.product.github %} provides you with a randomly generated "identicon". [Your identicon](https://github.com/blog/1586-identicons) generates from a hash of your user ID, so there's no way to control its color or pattern. You can replace your identicon with an image that represents you.
33-
34-
> [!NOTE] {% ifversion ghec %}
35-
> * {% endif %}Your profile picture should be a PNG, JPG, or GIF file, and it must be less than 1 MB in size and smaller than 3000 by 3000 pixels. For the best quality rendering, we recommend keeping the image at about 500 by 500 pixels.
36-
{% ifversion ghec %}> * Gravatar profile pictures are not supported with {% data variables.product.prodname_emus %}.{% endif %}
37-
38-
If you use Gravatar, and your Gravatar image is associated with the email you use for {% data variables.product.github %}, the image will be shown as your {% data variables.product.github %} profile picture by default (rather than an identicon). To change your profile picture, you can either upload a new image to Gravatar, or upload a new image to {% data variables.product.github %} and override the Gravatar image.
39-
40-
### Setting a profile picture
41-
42-
{% data reusables.user-settings.access_settings %}
43-
{% data reusables.accounts.set-profile-picture %}
44-
45-
### Resetting your profile picture to the identicon
46-
47-
{% data reusables.user-settings.access_settings %}
48-
1. Under "Profile Picture", select **{% octicon "pencil" aria-hidden="true" aria-label="pencil" %} Edit**, then click **Remove photo** to revert to your identicon.
49-
50-
If your email address is associated with a [Gravatar](https://en.gravatar.com/), you cannot revert to your identicon. Click **Revert to Gravatar** instead.
51-
52-
![Screenshot of the "Public profile" section of a user account's settings. A button, labeled with a pencil icon and "Edit", is outlined in dark orange.](/assets/images/help/profile/edit-profile-photo.png)
53-
54-
## Changing your profile name
55-
56-
You can change the name that is displayed on your profile. This name may also be displayed next to comments you make on private repositories owned by an organization. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/managing-the-display-of-member-names-in-your-organization).
13+
## Visibility of profile information
5714

5815
{% ifversion fpt or ghec %}
5916

60-
> [!NOTE]
61-
> If you're a member of an {% data variables.enterprise.prodname_emu_enterprise %}, any changes to your profile name must be made through your identity provider instead of {% data variables.product.prodname_dotcom %}. {% data reusables.enterprise-accounts.emu-more-info-account %}
17+
Any details you add to your public profile will be visible to all {% data variables.product.github %} users, including in regions where local laws, regulations, or cultural norms may pose risks to expressing your identity. We respect everyone's decision about whether or not to share information about themselves on their {% data variables.product.github %} profile.
6218

6319
{% endif %}
6420

65-
{% data reusables.user-settings.access_settings %}
66-
1. Under "Public profile", in the "Name" field, type the name you want to be displayed on your profile.
67-
68-
## Adding a bio to your profile
69-
70-
Add a bio to your profile to share information about yourself with other {% data variables.product.github %} users. With the help of [@mentions](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) and emoji, you can include information about where you currently or have previously worked, what type of work you do, or even what kind of coffee you drink.
71-
72-
For a longer-form and more prominent way of displaying customized information about yourself, you can also use a profile README. For more information, see [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme).
73-
74-
> [!NOTE]
75-
> If you have the activity overview section enabled for your profile and you @mention an organization you're a member of in your profile bio, then that organization will be featured first in your activity overview. For more information, see [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/showing-an-overview-of-your-activity-on-your-profile).
76-
77-
{% data reusables.user-settings.access_settings %}
78-
1. Under "Public profile", in the "Bio" field, type the content that you want displayed on your profile. The bio field is limited to 160 characters.
79-
80-
> [!TIP]
81-
> When you @mention an organization, only those that you're a member of will autocomplete. You can still @mention organizations that you're not a member of, like a previous employer, but the organization name won't autocomplete for you.
82-
83-
{% data reusables.profile.update-profile %}
21+
The name that is displayed on your profile may also be displayed next to comments you make on private repositories owned by an organization. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/managing-the-display-of-member-names-in-your-organization).
8422

8523
{% ifversion profile-pronouns %}
8624

87-
## Adding pronouns to your profile
88-
89-
Add pronouns to your public user profile to share information about yourself with other {% data variables.product.github %} users. {% data reusables.profile.pronouns-visibility %}
25+
{% data reusables.profile.pronouns-visibility %}
9026

91-
{% data reusables.user-settings.access_settings %}
92-
1. Under **Pronouns**, add the pronouns that you want displayed on your profile. You may add custom pronouns.
27+
{% endif %}
9328

94-
{% data reusables.profile.update-profile %}
29+
Links to your social accounts are visible to anyone who can view your profile.
9530

96-
{% endif %}
31+
## Profile status
9732

98-
## Setting your location and time zone
33+
Your status will show:
9934

100-
You can set a location and time zone on your profile to show other people your local time. Your location and time zone will be visible:
10135
* On your profile page
10236
* When people hover over your username or avatar
37+
* On a team page for a team where you're a team member. For more information, see [AUTOTITLE](/organizations/organizing-members-into-teams/about-teams#team-pages).
38+
* On the organization dashboard in an organization where you're a member. For more information, see [AUTOTITLE](/organizations/collaborating-with-groups-in-organizations/about-your-organization-dashboard).
10339

104-
![Screenshot of the Octocat profile page emphasizing the location, local time, and relative time fields.](/assets/images/help/profile/profile-location-and-time.png)
105-
106-
When you view your profile, you will see your location, local time, and your time zone in relation to Universal Time Coordinated. When others view your profile, they will see your location, local time, and the time difference in hours from their own local time.
107-
108-
{% data reusables.user-settings.access_settings %}
109-
1. Under "Public profile", in the "Location" field, type the location you want to be displayed on your profile.
110-
1. Optionally, display the current local time on your profile.
111-
* Select **Display current local time**.
112-
* Select the **Time zone** dropdown menu, then click your local time zone.
113-
{% data reusables.profile.update-profile %}
114-
115-
{% ifversion profile-social-links %}
116-
117-
## Adding links to your social accounts
118-
119-
You can add up to four links to social accounts on your profile. These are visible to anyone who can view your profile.
120-
121-
{% data reusables.user-settings.access_settings %}
122-
1. Under "Social accounts", in a blank "Link to social profile" field, type the full URL of the social account. For example, for the `@GitHub` Twitter account, type `https://twitter.com/github`.
123-
{% data reusables.profile.update-profile %}
40+
When you set your status, you can also let people know that you have limited availability.
12441

125-
{% endif %}
42+
If you select the "Busy" option, when people @mention your username, assign you an issue or pull request, or request a pull request review from you, a note next to your username will show that you're busy. You will also be excluded from automatic review assignment for pull requests assigned to any teams you belong to. For more information, see [AUTOTITLE](/organizations/organizing-members-into-teams/managing-code-review-settings-for-your-team).
12643

127-
{% ifversion fpt or ghec %}
44+
![Screenshot of a draft comment. "@octocat" is written in the text field, and "The Octocat (busy)" is suggested.](/assets/images/help/profile/username-with-limited-availability-text.png)
12845

129-
## Adding your ORCID iD to your profile
46+
## Profile picture requirements
13047

131-
If you're a researcher with an ORCID iD, you can identify yourself by adding your ORCID iD to your profile.
48+
When you sign up for an account, {% data variables.product.github %} provides you with a randomly generated "identicon". [Your identicon](https://github.com/blog/1586-identicons) generates from a hash of your user ID, so there's no way to control its color or pattern. You can replace your identicon with an image that represents you.
13249

133-
{% data reusables.user-settings.access_settings %}
134-
1. Under "ORCID iD", click **Connect your ORCID iD**.
135-
1. Follow the steps to sign in to your ORCID account and then return to {% data variables.product.prodname_dotcom %}.
50+
> [!NOTE] {% ifversion ghec %}
51+
> * {% endif %}Your profile picture should be a PNG, JPG, or GIF file, and it must be less than 1 MB in size and smaller than 3000 by 3000 pixels. For the best quality rendering, we recommend keeping the image at about 500 by 500 pixels.
52+
{% ifversion ghec %}> * Gravatar profile pictures are not supported with {% data variables.product.prodname_emus %}.{% endif %}
13653
137-
{% endif %}
54+
If you use Gravatar, and your Gravatar image is associated with the email you use for {% data variables.product.github %}, the image will be shown as your {% data variables.product.github %} profile picture by default (rather than an identicon). To change your profile picture, you can either upload a new image to Gravatar, or upload a new image to {% data variables.product.github %} and override the Gravatar image.
13855

139-
## Setting a status
56+
## Profile location and time zone
14057

141-
You can set a status to display information about your current availability. Your status will show:
58+
You can set a location and time zone on your profile to show other people your local time. Your location and time zone will be visible:
14259
* On your profile page
14360
* When people hover over your username or avatar
144-
* On a team page for a team where you're a team member. For more information, see [AUTOTITLE](/organizations/organizing-members-into-teams/about-teams#team-pages).
145-
* On the organization dashboard in an organization where you're a member. For more information, see [AUTOTITLE](/organizations/collaborating-with-groups-in-organizations/about-your-organization-dashboard).
146-
147-
When you set your status, you can also let people know that you have limited availability.
14861

149-
If you select the "Busy" option, when people @mention your username, assign you an issue or pull request, or request a pull request review from you, a note next to your username will show that you're busy. You will also be excluded from automatic review assignment for pull requests assigned to any teams you belong to. For more information, see [AUTOTITLE](/organizations/organizing-members-into-teams/managing-code-review-settings-for-your-team).
150-
151-
![Screenshot of a draft comment. "@octocat" is written in the text field, and "The Octocat (busy)" is suggested.](/assets/images/help/profile/username-with-limited-availability-text.png)
152-
153-
1. In the top right corner of {% data variables.product.prodname_dotcom %}, click your profile picture, then click **{% octicon "smiley" aria-hidden="true" aria-label="smiley" %} Set status** or, if you already have a status set, click your current status.
154-
155-
![Screenshot of the dropdown menu under @octocat's profile picture. A smiley icon and "Set status" are outlined in dark orange.](/assets/images/help/profile/set-status-on-profile-global-nav-update.png)
62+
![Screenshot of the Octocat profile page emphasizing the location, local time, and relative time fields.](/assets/images/help/profile/profile-location-and-time.png)
15663

157-
1. In the "What's happening" field, type a status message.
158-
1. Optionally, to set an emoji status, click {% octicon "smiley" aria-label="Choose an emoji" %}, then click an emoji from the list.
159-
1. Optionally, if you'd like to share that you have limited availability, select "Busy."
160-
1. Select the **Clear status** dropdown menu, then click when you want your status to expire. If you don't select a status expiration, you will keep your status until you clear or edit your status.
161-
1. Select the **Visible to** dropdown menu, then click who you want your status visible to. If you don't select an organization, your status will be public.
162-
1. Click **Set status**.
64+
When you view your profile, you will see your location, local time, and your time zone in relation to Universal Time Coordinated. When others view your profile, they will see your location, local time, and the time difference in hours from their own local time.
16365

16466
{% ifversion fpt or ghec %}
16567

@@ -188,6 +90,10 @@ To stop private contributions from counting toward your Achievements, or to turn
18890
> [!NOTE]
18991
> This feature is currently in {% data variables.release-phases.public_preview %} and subject to change.
19092
93+
## Profile name changes for {% data variables.enterprise.prodname_emu_enterprise %}
94+
95+
If you're a member of an {% data variables.enterprise.prodname_emu_enterprise %}, any changes to your profile name must be made through your identity provider instead of {% data variables.product.prodname_dotcom %}. {% data reusables.enterprise-accounts.emu-more-info-account %}
96+
19197
{% endif %}
19298

19399
## List of qualifying repositories for Mars 2020 Helicopter Contributor achievement

content/account-and-profile/tutorials/index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Tutorials for your GitHub account and profile
33
shortTitle: Tutorials
4-
intro: 'Build skills and knowledge about your {% data variables.product.github %} account and profile through hands-on activities.'
4+
intro: Build skills and knowledge about your {% data variables.product.github %} account and profile through hands-on activities.
55
versions:
66
fpt: '*'
77
ghes: '*'
@@ -11,6 +11,7 @@ topics:
1111
- Profiles
1212
children:
1313
- /managing-security-and-analysis-settings-for-your-personal-account
14+
- /personalize-your-profile
1415
- /managing-your-cookie-preferences-for-githubs-enterprise-marketing-pages
1516
- /using-your-github-profile-to-enhance-your-resume
1617
---

0 commit comments

Comments
 (0)