From de77521d1a4a4fb095ae786d4e1af8d57b3a0901 Mon Sep 17 00:00:00 2001 From: Alya Abbott Date: Fri, 9 Feb 2024 10:11:34 -0800 Subject: [PATCH] help: Improve descriptions of custom profile field types. Also reorder as in 60225591dcc947c61b1d13202942d86886a42839. --- help/custom-profile-fields.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/help/custom-profile-fields.md b/help/custom-profile-fields.md index a750b40ae1..8e3185c6f8 100644 --- a/help/custom-profile-fields.md +++ b/help/custom-profile-fields.md @@ -43,20 +43,20 @@ methods][authentication-production] documentation for details. ## Profile field types -There are several different types of fields available. +Choose the profile field type that's most appropriate for the requested information. -* **Text (short)**: For one line responses, like - "Job title". Responses are limited to 50 characters. -* **Text (long)**: For multiline responses, like "Biography". -* **Date**: For dates, like "Birthday". -* **Link**: For links to websites. -* **External account**: For linking to GitHub, Twitter, etc. +* **Date**: For dates (e.g., birthdays or work anniversaries). +* **Link**: For links to websites, including company-internal pages. +* **External account**: For linking to an account on GitHub, X (Twitter), etc. +* **List of options**: A dropdown with a list of predefined options (e.g., + office location). * **Pronouns**: What pronouns should people use to refer to the user? Pronouns are displayed in [user mention](/help/mention-a-user-or-group) autocomplete suggestions. -* **List of options**: Creates a dropdown with a list of options. -* **Users**: For selecting one or more users, like "Manager" or - "Direct reports". +* **Text (long)**: For multiline responses (e.g., a user's intro message). +* **Text (short)**: For one-line responses up to 50 characters (e.g., team + name or role in your organization). +* **Users**: For selecting one or more users (e.g., manager or direct reports). ## Display custom fields on user card