Skip to content
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

Document required ordering of clauses for @use and @forward #568

Open
bjg222 opened this issue Aug 6, 2021 · 1 comment
Open

Document required ordering of clauses for @use and @forward #568

bjg222 opened this issue Aug 6, 2021 · 1 comment

Comments

@bjg222
Copy link

bjg222 commented Aug 6, 2021

Documentation of the @use and @forward at-rules describes how to use the various clauses for namespacing (as), visibility (show/hide), and configuration (with) individually. However, I would propose adding notes about the allowable ordering of these clauses. The error dart-sass gives when compiling with clauses out of order can be vague if you're not aware of the ordering requirements, simply saying that a ';' was expected or similar. It took some searching and testing to determine that "as", "show", and "hide" must come before "with". It would be good to include this information in the online documentation.

@jathak
Copy link
Member

jathak commented Aug 18, 2021

Yeah, that makes sense. I've also filed sass/dart-sass#1443 to have Dart Sass output better error messages for cases like these.

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

2 participants