move visibility docs and add .visible mention

diff --git a/docs/_data/nav.yml b/docs/_data/nav.yml
index 0bb714b0fa6c1ed23d257f4b313f76da525e34fd..cf3bd929e370ebac9273ad18b9a7b1141aca4cc6 100644 (file)
--- a/docs/_data/nav.yml
+++ b/docs/_data/nav.yml
@@ -59,7 +59,6 @@
     - title: Display
     - title: Flexbox
     - title: Image replacement
-    - title: Invisible content
     - title: Position
     - title: Responsive helpers
     - title: Screenreaders
@@ -67,6 +66,7 @@
     - title: Spacing
     - title: Typography
     - title: Vertical align
+    - title: Visibility
 
 - title: Extend
   pages:

diff --git a/docs/utilities/invisible-content.md b/docs/utilities/invisible-content.md
deleted file mode 100644 (file)
index 84da6ad..0000000
--- a/docs/utilities/invisible-content.md
+++ /dev/null
@@ -1,23 +0,0 @@
----
-layout: docs
-title: Invisible content
-group: utilities
----
-
-The `.invisible` class can be used to toggle only the visibility of an element, meaning its `display` is not modified and the element can still affect the flow of the document.
-
-{% highlight html %}
-<div class="invisible">...</div>
-{% endhighlight %}
-
-{% highlight scss %}
-// Class
-.invisible {
-  visibility: hidden;
-}
-
-// Usage as a mixin
-.element {
-  @include invisible;
-}
-{% endhighlight %}

diff --git a/docs/utilities/visibility.md b/docs/utilities/visibility.md
new file mode 100644 (file)
index 0000000..5b7d286
--- /dev/null
+++ b/docs/utilities/visibility.md
@@ -0,0 +1,32 @@
+---
+layout: docs
+title: Visibility
+group: utilities
+---
+
+Set the `visibility` of elements with our visibility utilities. These do not modify the `display` value at all and are helpful for hiding content from most users, but still keeping them for screen readers.
+
+Apply `.visible` or `.invisible` as needed.
+
+{% highlight html %}
+<div class="visible">...</div>
+<div class="invisible">...</div>
+{% endhighlight %}
+
+{% highlight scss %}
+// Class
+.visible {
+  visibility: visible;
+}
+.invisible {
+  visibility: hidden;
+}
+
+// Usage as a mixin
+.element {
+  @include invisible(visible);
+}
+.element {
+  @include invisible(hidden);
+}
+{% endhighlight %}