jpmorganchase / salt-ds

React UI components built with a focus on accessibility, customisation and ease-of-use
https://www.saltdesignsystem.com
Apache License 2.0
109 stars 78 forks source link

Update Characteristics spec template #3645

Open pseys opened 4 days ago

pseys commented 4 days ago

There's an opportunity to streamline the way we document our characteristics within Salt component and pattern specs. It may also be a useful resource for designers outside the core team.

origami-z commented 4 days ago

Minor point - "always up to date" may be a false positive one, specs need design attention whether to update from library in each file. May increase maintenance for additional component with little return

Having dark vars in spec is a good reference point. With variable modes, it should be easy to copy the whole tokens layers from top and set to dark mode at the bottom.

Maybe something in the middle ground, have a template with text set to content variable. Each token to be manually set with text and color block?