terra-ui icon indicating copy to clipboard operation
terra-ui copied to clipboard

CSS documentation needs to be more face up

Open calebmeyer opened this issue 5 years ago • 0 comments
trafficstars

Issue Description

Terra uses a crazy (to me) number of plugins for CSS. For javascript, it's basically just babel and react, but for CSS we have all of these: image

This is incredibly overwhelming, and a big hurdle to newcomers. There was a teams conversation (this one) where someone asked for help understanding our CSS at Cerner, and I realized it wasn't well documented anywhere that I had seen. Turns out it is well documented, but it's in contributing instead of getting started.

Issue Type

  • [ ] New Feature
  • [x] Enhancement
  • [ ] Bug
  • [ ] Other

Expected Behavior

There should be a link or we should move our CSS style guide to getting started

Current Behavior

CSS style guide is in contributing, meaning most people will never see it.

Steps to Reproduce

Go to the docs page here: https://engineering.cerner.com/terra-ui/getting-started/terra-ui/webpack and see that there's no indication of how to use all these CSS plugins

Environment

  • Component Version: all
  • Browser Name and Version: any
  • Operating System and version (desktop or mobile): all

calebmeyer avatar Mar 25 '20 14:03 calebmeyer