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

Documentation could use an update to @import to include alternative for Nesting use case #1301

Open
shanemac10 opened this issue Jan 17, 2025 · 0 comments
Assignees

Comments

@shanemac10
Copy link

shanemac10 commented Jan 17, 2025

The @import documentation includes @forward and @use as recommended at-rules to use to replace the now deprecated @import at-rule, but there is no mention of a suitable alternative for the Nesting functionality use case.

I spent several hours trying to figure out what to use instead, going through each at-rule doc, re-reading the @forward and @use docs, but without any luck. The way this deprecation has been framed is that @forward and @use are THE replacements for the @import use cases, so I got fixated on searching for a way to use them. Eventually a Google search finally brought me to Breaking Change: Invalid Combinators and then I was able to find the Migrator Module mention in the documentation as well by searching "nested import" on your documentation site. But it would have saved me so much headache if there were simply something @import documentation.

Please please please please please add something like the following to the @import Nesting documentation section.

⚠️ Heads up!
Nested imports should use the meta.load-css() mixin instead.

The console warnings for my nested imports were as follows, so it would be lovely if the doc covered their use case.

More info and automated migrator: https://sass-lang.com/d/import

@shanemac10 shanemac10 changed the title Documentation could use an update @import to include alternative for Nesting use case Documentation could use an update to @import to include alternative for Nesting use case Jan 17, 2025
@nex3 nex3 transferred this issue from sass/sass Jan 21, 2025
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

3 participants