chakra-ui-docs icon indicating copy to clipboard operation
chakra-ui-docs copied to clipboard
verified publisher icon chakra-ui

Component styling doc is unclear, lacking and misleading

Open embostan opened this issue 2 years ago • 0 comments

Subject

Component Styling

Description

https://github.com/chakra-ui/chakra-ui-docs/blob/0bc42c4c0845554794112f9d46cd236403eaf1e1/content/docs/styled-system/component-style.mdx

This doc page does not explain which props belong to which group (baseStyle, size, ...), which can lead users to override a prop in the wrong place and wonder why no visual change happens: https://github.com/chakra-ui/chakra-ui/issues/3293

Some parts are even misleading: image I would infer from this that any prop can be specified in baseStyle, and that the following groups (size, variants...) override baseStyle.

embostan avatar Jul 29 '23 14:07 embostan