Adjusting onboarding copy for better readability (#16570)

* adjusting copy for better readability

* addressing some review feedback

Author: selfcontained

components/dashboard/src/onboarding/StepOrgInfo.tsx

@@ -150,11 +150,6 @@ export const StepOrgInfo: FC<Props> = ({ user, onComplete }) => {
                     }
                     setJobRole(val);
                 }}
-                hint={
-                    jobRole !== JOB_ROLE_OTHER
-                        ? "Please select the role that best describes the type of work you'll use Gitpod for"
-                        : ""
-                }
                 error={jobRoleError.message}
                 onBlur={jobRoleError.onBlur}
             >
@@ -166,16 +161,7 @@ export const StepOrgInfo: FC<Props> = ({ user, onComplete }) => {
             </SelectInputField>
 
             {jobRole === JOB_ROLE_OTHER && (
-                <TextInputField
-                    value={jobRoleOther}
-                    onChange={setJobRoleOther}
-                    placeholder="Please specify"
-                    hint={
-                        jobRole === JOB_ROLE_OTHER
-                            ? "Please select the role that best describes the type of work you'll use Gitpod for"
-                            : ""
-                    }
-                />
+                <TextInputField value={jobRoleOther} onChange={setJobRoleOther} placeholder="Please share (optional)" />
             )}
 
             <TextInputField
@@ -205,7 +191,7 @@ export const StepOrgInfo: FC<Props> = ({ user, onComplete }) => {
                 ))}
             </CheckboxInputField>
 
-            <CheckboxInputField label="I'm signing up for Gitpod to...">
+            <CheckboxInputField label="I'm signing up for Gitpod for...">
                 {signupGoalsOptions.map((o) => (
                     <CheckboxInput
                         key={o.value}
@@ -224,7 +210,11 @@ export const StepOrgInfo: FC<Props> = ({ user, onComplete }) => {
             </CheckboxInputField>
 
             {signupGoals.includes(SIGNUP_GOALS_OTHER) && (
-                <TextInputField value={signupGoalsOther} placeholder="Please specify" onChange={setSignupGoalsOther} />
+                <TextInputField
+                    value={signupGoalsOther}
+                    placeholder="Please share (optional)"
+                    onChange={setSignupGoalsOther}
+                />
             )}
         </OnboardingStep>
     );

components/dashboard/src/onboarding/exploration-reasons.ts

@@ -7,10 +7,10 @@
 export const getExplorationReasons = () => {
     return [
         { value: "explore-professional", label: "For work" },
-        { value: "explore-personal", label: "For personal projects, or open-source" },
+        { value: "explore-personal", label: "For personal projects or open-source" },
         {
             value: "replace-remote-dev",
-            label: "To replace remote/containerized development (VDI, VM based, Docker Desktop,...)",
+            label: "To replace remote/containerized development (VDI, VM, Docker Desktop)",
         },
     ];
 };

components/dashboard/src/onboarding/job-roles.ts

@@ -9,13 +9,13 @@ export const JOB_ROLE_OTHER = "other";
 export const getJobRoleOptions = () => {
     return [
         { value: "", label: "Please select one" },
-        { value: "software-eng", label: "Software Engineer" },
+        { value: "software-eng", label: "Software Engineering" },
         { value: "data", label: "Data / Analytics" },
-        { value: "academics", label: "Academic (Student, Researcher)" },
-        { value: "enabling", label: "Enabling team (Platform, Developer Experience)" },
-        { value: "team-lead", label: "Team / Function Lead" },
+        { value: "academics", label: "Academia (Student, Researcher)" },
+        { value: "enabling", label: "Platform or Developer Experience" },
+        { value: "team-lead", label: "A Team Lead or Function Lead role" },
         { value: "devrel", label: "DevRel" },
-        { value: "product-design", label: "Product (PM, Designer)" },
-        { value: JOB_ROLE_OTHER, label: "Other - please specify / prefer not to say" },
+        { value: "product-design", label: "Product" },
+        { value: JOB_ROLE_OTHER, label: "Other" },
     ];
 };

components/dashboard/src/onboarding/signup-goals.ts

@@ -12,6 +12,6 @@ export const getSignupGoalsOptions = () => {
         { value: "onboarding", label: "Faster onboarding" },
         { value: "powerful-resources", label: "More powerful dev resources" },
         { value: "security", label: "More secure dev process" },
-        { value: SIGNUP_GOALS_OTHER, label: "Other - please specify / prefer not to say" },
+        { value: SIGNUP_GOALS_OTHER, label: "Other" },
     ];
 };