fleet icon indicating copy to clipboard operation
fleet copied to clipboard

Dashboard: update OS copy

Open rachaelshaw opened this issue 9 months ago • 9 comments

Goal

User story
As an IT admin,
I want to see consistent names for platforms
so that I can more easily understand what I'm seeing

Key result

Original requests

Context

  • Product designer: @eugkuo

Changes

Product

  • [ ] UI changes: Figma link
  • [ ] CLI (fleetctl) usage changes: None
  • [ ] YAML changes: None
  • [ ] REST API changes: None
  • [ ] Fleet's agent (fleetd) changes: None
  • [ ] Activity changes: None
  • [ ] Permissions changes: None
  • [ ] Changes to paid features or tiers: None
  • [ ] Transparency changes: None
  • [ ] First draft of test plan added
  • [ ] Other reference documentation changes: None
  • [ ] Once shipped, requester has been notified
  • [ ] Once shipped, dogfooding issue has been filed

Engineering

  • [ ] Test plan is finalized
  • [ ] Feature guide changes: Global search on docs for old names

ℹ️  Please read this issue carefully and understand it. Pay special attention to UI wireframes, especially "dev notes".

QA

Risk assessment

  • Risk level: Low

Test plan

See copy changes in figma file.

Testing notes

Confirmation

  1. [ ] Engineer: Added comment to user story confirming successful completion of test plan.
  2. [ ] QA: Added comment to user story confirming successful completion of test plan.

rachaelshaw avatar Feb 14 '25 20:02 rachaelshaw

Added a PR for specifically the changes in the original request. Next few comments will be other places in the UI where we're using device name rather than platform.

iansltx avatar Mar 01 '25 18:03 iansltx

"Chromebook"

Switch to (check one):

  • [ ] ChromeOS hosts
  • [ ] ChromeOS devices
  • [ ] __________

Found in (check ones we want to fix):

  • [ ] Add hosts > Advanced
Image
  • [ ] Dashboard filtered to ChromeOS platform, Operating systems card
Image
  • [ ] Dashboard filtered to ChromeOS platform, Low disk space card
Image
  • [ ] Host details > Encryption status
Image
  • [ ] Host details > Queries
Image
  • [ ] Host details > Agent options
Image
  • [ ] Queries > Query automations modal
Image
  • [ ] fleetd-chrome computer naming

iansltx avatar Mar 01 '25 18:03 iansltx

iPads / iPhones

Switch to:

  • [ ] iPads: ________ (iPadOS hosts?)
  • [ ] iPhones: _________ (iOS hosts?)
  • [ ] iPads and iPhones: __________

Found in (check ones we want to fix):

  • [ ] New query "Compatible with" tooltip
Image
  • [ ] ABM add instructions (probably don't want to change since this reflect's Apple's wording in ABM IIRC)
Image
  • [ ] Host details > Policies
Image
  • [ ] Host details > Queries
Image

iansltx avatar Mar 01 '25 18:03 iansltx

Also confirmed that "iPhone" and "Chromebook" aren't mentioned in strings that out be output from the backend.

For iPads, I global-searched for iPad , iPad", and iPads to filter out references to IP addresses and iPadOS. Only cases I can see is the "shared iPad" enrollment type, but that looks like it should stay as-is, plus an error message context that I'm fixing now.

So the above inventory is comprehensive and all potential fixes are frontend-only.

iansltx avatar Mar 01 '25 19:03 iansltx

@iansltx and @RachelElysia: I've added a link to this figma file which includes copy updates to the dashboard as well as the above examples that Ian provided (thanks tons to Ian for providing them).

@mostlikelee As these copy changes seem pretty uncontroversial, I'll move this ticket to User story review and we can go over the changes at our next review.

cc @noahtalerman

eugkuo avatar Mar 07 '25 18:03 eugkuo

@eugkuo can you make the Figma public?

iansltx avatar Mar 10 '25 17:03 iansltx

Please add your planning poker estimate with Zenhub @RachelElysia

mostlikelee avatar Mar 12 '25 16:03 mostlikelee

@mostlikelee

Estimate: 2 (Bold 1, rounding to 2 including confirm changes required in docs/marketing website)

RachelElysia avatar Mar 12 '25 19:03 RachelElysia

QA Notes

Confirmed platform cards have been updated to "ChromeOS", "iOS", and "iPadOS" and when the dashboard is filtered to ChromeOS, the copy under "Operating systems" shows the learn more link.

jmwatts avatar Mar 21 '25 20:03 jmwatts

Consistent platform names, Clear as glass cities in clouds, Ease for IT's game.

fleet-release avatar Apr 07 '25 14:04 fleet-release