fleet icon indicating copy to clipboard operation
fleet copied to clipboard

MDM install instructions are incorrect

Open zwass opened this issue 1 year ago • 7 comments

Fleet version: 4.52.0

macOS 13.2.1 (also checked on macOS 14.5 and see same issues)


💥  Actual behavior

Instructions say to click "Enrollment Profile". Profile is actually called "Migration Test enrollment". I'm guessing the profile is always called "[Organization Name] enrollment"? Screenshot 2024-06-26 at 9 44 29 AM

Instructions say to "select Install" but there is no "Install" option. Screenshot 2024-06-26 at 9 50 49 AM

🧑‍💻  Steps to reproduce

  1. Go to My Device page on a device that is not enrolled in MDM.
  2. Follow instructions to enroll.

🕯️ More info (optional)

N/A

🛠️ To fix

Figma link

zwass avatar Jun 26 '24 16:06 zwass

@marko-lisica looks like we need to remove and select install. from Step 4 and maybe replace Enrollment Profile with [Organization name] enrollment profile or similar?

Example: 4. In the search bar, type "Profiles". Select Profiles, then double click the [Organization name] enrollment profile.

PezHub avatar Jun 27 '24 01:06 PezHub

@PezHub Do you know if the profile is always called [Org name] enrollment? I see in our enrollment profile that PayloadDisplayName is set to "Fleet enrollment". So it might be anything in that case.

Screenshot 2024-06-28 at 16 57 51

In Fleet's copy we always refer to UI elements with bold text. In this case we refer to Enrollment Profile as UI element and not to the name. Not sure if that makes sense. In this case I would just change Install to Enroll since button is called differently now.

@noahtalerman Do you know if PayloadDisplayName is displayed in Profiles pane in System Settings?

marko-lisica avatar Jun 28 '24 15:06 marko-lisica

@marko-lisica Just ran a quick test and renamed my local instance and can confirm It's pulling the 'Organization Name' then appending enrollment

In Fleet's copy we always refer to UI elements with bold text. In this case we refer to Enrollment Profile as UI element and not to the name. Not sure if that makes sense.

Yeah, that makes sense. Maybe adding the word "the" in front of Enrollment Profile would help?

For the install -> Enroll copy change just keep in mind if you replace install with Enroll, you'll want to eliminate Step 5.

PezHub avatar Jun 28 '24 15:06 PezHub

@PezHub Good point. I think you were right in the first place. We can remove and select install. I guess in Sonoma they removed this extra step to "Install" profile and user get this "Enroll" dialog instead?

marko-lisica avatar Jun 28 '24 16:06 marko-lisica

I just checked Ventura and it's the same workflow as Sonoma so perhaps it was macOS12 and earlier

PezHub avatar Jun 28 '24 17:06 PezHub

Hey @PezHub and @georgekarrv, I just added Figma link with copy changes in the "To fix" section of issue description.

marko-lisica avatar Jul 01 '24 15:07 marko-lisica

confirmed copy is updated on both macOS 13 and 14. Screenshot 2024-07-01 at 11 21 11 PM QA Approved!

p.s. Sequoia renamed Profiles toDevice Management in System Settings so we will need to revisit once ver 15 drops 🫠

PezHub avatar Jul 02 '24 06:07 PezHub

Correct instructions shine, Like a beacon in the cloud. Fleet's path, now aligned.

fleet-release avatar Jul 17 '24 22:07 fleet-release