From b67b2c7f49d67e9734ddab16cce15d220a9d1fe5 Mon Sep 17 00:00:00 2001
From: Mark Otto <markdotto@gmail.com>
Date: Tue, 23 Dec 2014 14:00:34 -0800
Subject: [PATCH] fix up helpers docs again for .invisible and [hidden]

---
 docs/components/helpers.md | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/docs/components/helpers.md b/docs/components/helpers.md
index 1d347b9e9d..2717f62b80 100644
--- a/docs/components/helpers.md
+++ b/docs/components/helpers.md
@@ -132,7 +132,7 @@ Easily clear `float`s by adding `.clearfix` **to the parent element**. Utilizes
 }
 {% endhighlight %}
 
-### Hidden elements
+### Hidden content
 
 Hide any HTML element with the `[hidden]` attribute. Previously, v3.x included a `.hidden` class that forced toggled content. However, we removed it due to conflicts with jQuery's `hide()` function. It's taken from [PureCSS](http://purecss.io).
 
@@ -142,14 +142,25 @@ Furthermore, `.invisible` can be used to toggle the visibility of an element, me
 <input type="text" hidden>
 {% endhighlight %}
 
-### Visible elements
+### Invisible content
 
-On the other side of hiding content, you can show content with `.show`.
+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="show">...</div>
+<div class="invisible">...</div>
 {% endhighlight %}
 
+{% highlight scss %}
+// Classes
+.invisible {
+  visibility: hidden;
+}
+
+// Usage as mixin
+.element {
+  .invisible();
+}
+
 ### Screen readers and keyboard navigation
 
 Hide an element to all devices **except screen readers** with `.sr-only`. Combine `.sr-only` with `.sr-only-focusable` to show the element again when it's focused (e.g. by a keyboard-only user). Necessary for following [accessibility best practices](../getting-started/#accessibility). Can also be used as mixins.