From a79e7db6bd3ecfb55dc0d84372fbe32ba3b3292b Mon Sep 17 00:00:00 2001
From: Mark Otto <markdotto@gmail.com>
Date: Tue, 18 Aug 2015 19:30:22 -0700
Subject: [PATCH] document some help text examples to the docs

---
 docs/components/forms.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/docs/components/forms.md b/docs/components/forms.md
index 1e467e8852..e7deaa1ab9 100644
--- a/docs/components/forms.md
+++ b/docs/components/forms.md
@@ -515,10 +515,18 @@ Wrap inputs in grid columns, or any custom parent element, to easily enforce des
 
 ## Help text
 
-Block level help text for form controls.
+No official help text classes exist in Bootstrap 4 (previously we had `.help-block` in v3), but thanks to our utility classes, you can create much more flexible help text as you need it.
 
 {% example html %}
-<p class="text-help">A block of help text that breaks onto a new line and may extend beyond one line.</p>
+<!-- Inline -->
+<small class="text-muted">Some inline text with a small tag looks like this.</small>
+{% endexample %}
+
+{% example html %}
+<!-- Block -->
+<p class="text-muted">
+  A block of help text that breaks onto a new line and may extend beyond one line.
+</p>
 {% endexample %}
 
 ## Validation