From 39cda30dab9a9787a69f2ac3f34558d6abafa68f Mon Sep 17 00:00:00 2001
From: Thomas Heartman <thomas@getunleash.io>
Date: Fri, 26 Jul 2024 11:57:22 +0200
Subject: [PATCH] chore: update description/docs for the new feature creation
 dialog fields (#7677)

This PR updates the text used to describe the different fields used in
the new creation dialog.

It also removes a redundant aria attribute (that MUI already handles).
---
 .../CreateFeatureDialog.tsx                          | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/frontend/src/component/project/Project/PaginatedProjectFeatureToggles/ProjectFeatureTogglesHeader/CreateFeatureDialog.tsx b/frontend/src/component/project/Project/PaginatedProjectFeatureToggles/ProjectFeatureTogglesHeader/CreateFeatureDialog.tsx
index 1567084ada..1133936458 100644
--- a/frontend/src/component/project/Project/PaginatedProjectFeatureToggles/ProjectFeatureTogglesHeader/CreateFeatureDialog.tsx
+++ b/frontend/src/component/project/Project/PaginatedProjectFeatureToggles/ProjectFeatureTogglesHeader/CreateFeatureDialog.tsx
@@ -58,20 +58,20 @@ const StyledDialog = styled(Dialog)(({ theme }) => ({
 const configButtonData = {
     project: {
         icon: <ProjectIcon />,
-        text: 'Projects allow you to group feature flags together in the management UI.',
+        text: 'Projects allow you to group feature flags together in the Unleash admin UI and in SDK payloads.',
     },
     tags: {
         icon: <Label />,
-        text: 'Tags are used to group flags together in Unleash.',
+        text: 'Tags are used to label flags in Unleash. They can be used when filtering flags in the UI. Additionally, they are used by some integrations.',
     },
     type: {
         icon: <FlagIcon />,
-        text: "A flag's type conveys its purpose.",
+        text: "A flag's type conveys its purpose. All types have the same capabilities, but choosing the right type signals what kind of flag it is. You can change this at any time.",
     },
 
     impressionData: {
         icon: <ImpressionDataIcon />,
-        text: 'Impression data is used to track how your flag is performing.',
+        text: `Impression data is used to track how your flag is performing. When enabled, you can subscribe to 'impression events' in the SDK and process them according to your needs.`,
     },
 };
 
@@ -109,8 +109,8 @@ export const CreateFeatureDialog = ({
         text: string;
         link?: { url: string; label: string };
     } = {
-        icon: <FlagIcon aria-hidden='true' />,
-        text: 'Feature flags are the core of Unleash.',
+        icon: <FlagIcon />,
+        text: 'Feature flags are at the core of Unleash. Use them to control your feature rollouts.',
         link: {
             url: 'https://docs.getunleash.io/reference/feature-toggles',
             label: 'Feature flags documentation',