Skip to content

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

@shanemac10

Description

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

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions