From d4457b33032d2540a4a3b7fa600f22055ce2000d Mon Sep 17 00:00:00 2001
From: Mark Otto <markdotto@gmail.com>
Date: Sun, 15 May 2016 12:37:47 -0700
Subject: [PATCH] improve docs examples for .navbar-text

---
 docs/components/navbar.md | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/docs/components/navbar.md b/docs/components/navbar.md
index 086d49bcba..a82f881a21 100644
--- a/docs/components/navbar.md
+++ b/docs/components/navbar.md
@@ -142,18 +142,32 @@ Navbars may contain bits of text with the help of `.navbar-text`. This class adj
 
 {% example html %}
 <nav class="navbar navbar-light bg-faded">
-  <span class="navbar-text">Navbar text with an inline element</span>
+  <span class="navbar-text">
+    Navbar text with an inline element
+  </span>
 </nav>
 {% endexample %}
 
-Using our utility classes, you can change the alignment of your navbar text.
+Using our utility classes, you can change the alignment and appearance of your navbar text.
 
 {% example html %}
 <nav class="navbar navbar-light bg-faded">
-  <span class="navbar-text pull-xs-right">Navbar text that's floated right</span>
+  <span class="navbar-text pull-xs-right text-muted">
+    Muted navbar text that's floated right
+  </span>
 </nav>
 {% endexample %}
 
+Similarly, you can use utility classes to align navbar text to other navbar elements like the brand and navigation (which are automatically floated already).
+
+{% example html %}
+<nav class="navbar navbar-light bg-faded">
+  <a class="navbar-brand" href="#">Navbar</a>
+  <span class="navbar-text pull-xs-left">
+    Navbar text that's floated left
+  </span>
+</nav>
+{% endexample %}
 
 ## Color schemes