fleet
fleet copied to clipboard
Dashboard: update OS copy
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
- [ ] Engineer: Added comment to user story confirming successful completion of test plan.
- [ ] QA: Added comment to user story confirming successful completion of test plan.
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.
"Chromebook"
Switch to (check one):
- [ ] ChromeOS hosts
- [ ] ChromeOS devices
- [ ] __________
Found in (check ones we want to fix):
- [ ] Add hosts > Advanced
- [ ] Dashboard filtered to ChromeOS platform, Operating systems card
- [ ] Dashboard filtered to ChromeOS platform, Low disk space card
- [ ] Host details > Encryption status
- [ ] Host details > Queries
- [ ] Host details > Agent options
- [ ] Queries > Query automations modal
- [ ] fleetd-chrome computer naming
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
- [ ] ABM add instructions (probably don't want to change since this reflect's Apple's wording in ABM IIRC)
- [ ] Host details > Policies
- [ ] Host details > Queries
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 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 can you make the Figma public?
Please add your planning poker estimate with Zenhub @RachelElysia
@mostlikelee
Estimate: 2 (Bold 1, rounding to 2 including confirm changes required in docs/marketing website)
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.
Consistent platform names, Clear as glass cities in clouds, Ease for IT's game.