carbon-design-system / carbon

A design system built by IBM
https://www.carbondesignsystem.com
Apache License 2.0
7.8k stars 1.8k forks source link

Carbon coverage: Refine message language and options #17599

Open RichKummer opened 1 week ago

RichKummer commented 1 week ago

After our last feedback session with the design and development cohort, it is clear that the current roster of issues is confusing, with some message language being unclear or dated. We should update the messages and logic to make clear what each issue is highlighting.

Considerations:

See logic breakdown in Figma

RichKummer commented 2 days ago

Current messages

Logic Current message Updated message Update
A Carbon v11 component that has an element overridden, but not detached Overridden Carbon instance. Please reset changes Carbon v11 component is overridden  
A non-Carbon v11 component. Can be either local or from another library Instance is not a Carbon instance. N/A 🚫 Remove – Designers clarified that they might use many components not from v11 directly.
A mixed text element that is not totally using Carbon v11. A single text string can have mixed styling. Text is not from Carbon Text style is not from Carbon v11 🔧 Update needed
A text element that is a single style, which is not a v11 text color style. Text Color style should only use surface/text or feedback/text tokens  Text color is not from Carbon v11 🔧 Update needed    
N/A Use a Divider Component instead N/A 🚫 Remove – likely a holdover from previous build
An effect that is not from Carbon v11 “Effects not from Carbon's elevation styles Effect is not from Carbon v11 ⏸️ Logic update paused, remove message for now
Any element that uses a border that does not come from Carbon v11 Box border color should only use surface/border tokens Border color is not from Carbon v11 🔧 Update needed
N/A Box not adhering to [Carbon] guidelines N/A 🚫 Remove – likely a holdover from previous build
A non-Carbon v11 component Not created using Carbon Components/Tokens [Unclear if we need this]  
N/A Use relevant Carbon component N/A 🚫 Remove – likely a holdover from previous build

Pending new messages

Logic Updated message Update
A detached Carbon v11 component This Carbon v11 component is detached ⚠️ Pending dev exploration
A Carbon v10 component from the All themes library This is a v10 component. Please update to the v11 library ⚠️ Pending dev exploration