jantimon / jantimon/css-variable
Please add better docs and examples
- Dominant language
- JavaScript
- Stars
- 91
- Forks
- 7
- PR merge metrics
- No merged PRs in 30d
Description
As a css-in-js newbie, i have really no idea how to use this lib when i read only the website.
After study the code and the examples it got clearer. But big waste of time, if everybody has to do that.
You should add a sentence for which benefit this lib is absolute needed and superior to other solutions.
E.g. why should i use this and not the things inlcuded in styled-components like theming?
`smaller virtual DOM updates` for a newbie like me, how, what perfomance gain could i expect?
Example from Webpage:
What are tokens?
Why i need and define tokens?
Confusing example "Create themeable CSS Snipptes": What is gradientStartColor variable? is it mistyped startColor?
Describe the api:
Which parameters has createVar?
How to access them? with .val, with .toStyle(...)?
createGlobalTheme with scope without scope `""`, difference?
Contributor guide
No contributing guide indexed for this repository
Research direction
Start with the website documentation and examples, then inspect the documented createVar and createGlobalTheme entry points. Clarify the library's benefits, token concepts, the gradientStartColor example, createVar parameters and access methods, and scoped versus unscoped createGlobalTheme usage; done means a CSS-in-JS newcomer can follow the examples without studying the source.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- css, javascript
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100