Skip to content

Better docs with examples #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ai opened this issue Jan 14, 2015 · 10 comments
Open

Better docs with examples #1

ai opened this issue Jan 14, 2015 · 10 comments

Comments

@ai
Copy link
Member

ai commented Jan 14, 2015

We should add better docs with examples for popular user cases like lighten/darken color. Now you need to open W3C spec and it is very bad for quick look. There is no examples or any way to find answer quickly.

For example, some people even think, that plugin didn’t support lighten :).

/cc @MoOx

MoOx added a commit that referenced this issue Jan 14, 2015
@MoOx
Copy link
Contributor

MoOx commented Jan 14, 2015

Most people don't look for before asking.

Anyway I've update the readme a little. Tell me if that enough.

@ai
Copy link
Member Author

ai commented Jan 14, 2015

[lightness( | l(] ['+' | '-' | '*']? <percentage> ) is too complicated without examples :(. “lightness has a l alias” is better for first part of statement. What does * mean?

@ai
Copy link
Member Author

ai commented Jan 14, 2015

blend( <color> <percentage> [rgb | hsl | hwb]? ) what is default value if I miss last arg? Also many people didn’t know hos blend depends on color mode.

@ai
Copy link
Member Author

ai commented Jan 14, 2015

But now it is better :).

@MadLittleMods
Copy link

More examples would really clear things up 👍

@ghost
Copy link

ghost commented Jul 17, 2015

Need example of how to make this:
scale-color($MYcolor, $saturation: +5%, $lightness: -16%);

And how to output Hex values.

@9mm
Copy link

9mm commented Sep 18, 2015

background: color(var(--blue) lightness(5%));

@Ser-Gen
Copy link
Contributor

Ser-Gen commented Dec 9, 2015

You are repeatedly refer to the specification, but I don't see any link.
Add it, please: https://drafts.csswg.org/css-color/#modifying-colors

@MoOx
Copy link
Contributor

MoOx commented Dec 9, 2015

You can do it yourself. PR are always welcome.

@Ser-Gen
Copy link
Contributor

Ser-Gen commented Dec 9, 2015

Done: #20.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

6 participants