Document the @use rule

Closes sass#361
asaf400 · Sep 2, 2019 · 196b981 · 196b981
1 parent 2454333
commit 196b981
Show file tree

Hide file tree

Showing 8 changed files with 471 additions and 42 deletions.
diff --git a/source/code-snippets/_example-use-with.html.erb b/source/code-snippets/_example-use-with.html.erb
@@ -0,0 +1,34 @@
+<% example do %>
+  // _library.scss
+  $black: #000 !default;
+  $border-radius: 0.25rem !default;
+  $box-shadow: 0 0.5rem 1rem rgba($black, 0.15) !default;
+
+  code {
+    border-radius: $border-radius;
+    box-shadow: $box-shadow;
+  }
+  ---
+  // style.scss
+  @use 'library' with (
+    $black: #222,
+    $border-radius: 0.1rem
+  );
+  ===
+  // _library.sass
+  $black: #000 !default
+  $border-radius: 0.25rem !default
+  $box-shadow: 0 0.5rem 1rem rgba($black, 0.15) !default
+
+  code
+    border-radius: $border-radius
+    box-shadow: $box-shadow
+  ---
+  // style.sass
+  @use 'library' with ($black: #222, $border-radius: 0.1rem)
+  ===
+  code {
+    border-radius: 0.1rem;
+    box-shadow: 0 0.5rem 1rem rgba(#222, 0.15);
+  }
+<% end %>
diff --git a/source/documentation/at-rules/forward.html.md.erb b/source/documentation/at-rules/forward.html.md.erb
@@ -3,3 +3,5 @@ title: "@forward"
 introduction: >
   TODO(nweiz): Write this
 ---
+
+## Controlling Visibility