document some help text examples to the docs

diff --git a/docs/components/forms.md b/docs/components/forms.md
index 1e467e885292d909c2b6ca01c567a98373e99621..e7deaa1ab9f3c70be2f397919b0a5bb320cff737 100644 (file)
--- 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