From d1a0af8b24c09d5558cba0e65c34d1f1292e6085 Mon Sep 17 00:00:00 2001
From: Chris Rebert <code@chrisrebert.com>
Date: Sun, 6 Dec 2015 17:43:25 -0800
Subject: [PATCH] Tweak naming and docs of font utility classes

* `.font-normal` is too generic. Rename it to `.font-weight-normal` for clarity.
* Rename `.font-bold` to `.font-weight-bold` so as to parallel `.font-weight-normal`.
* In docs, gloss "weight" term in relation to fonts for the benefit of non-typographiles.

Refs #18433

[skip sauce]
---
 docs/components/utilities.md | 8 ++++----
 scss/_utilities.scss         | 6 +++---
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/components/utilities.md b/docs/components/utilities.md
index c73db767fa..940219263a 100644
--- a/docs/components/utilities.md
+++ b/docs/components/utilities.md
@@ -121,13 +121,13 @@ Transform text in components with text capitalization classes.
 <p class="text-capitalize">CapiTaliZed text.</p>
 {% endexample %}
 
-## Font weight and style
+## Font weight and italics
 
-Quickly change the weight and style of text.
+Quickly change the weight (boldness) of text or italicize text.
 
 {% example html %}
-<p class="font-normal">Normal text.</p>
-<p class="font-bold">Bold text.</p>
+<p class="font-weight-bold">Bold text.</p>
+<p class="font-weight-normal">Normal weight text.</p>
 <p class="font-italic">Italicized text.</p>
 {% endexample %}
 
diff --git a/scss/_utilities.scss b/scss/_utilities.scss
index 78265a31fe..520666ec1d 100644
--- a/scss/_utilities.scss
+++ b/scss/_utilities.scss
@@ -74,9 +74,9 @@
 
 // Weight and italics
 
-.font-normal  { font-weight: normal; }
-.font-bold    { font-weight: bold; }
-.font-italic  { font-style: italic; }
+.font-weight-normal  { font-weight: normal; }
+.font-weight-bold    { font-weight: bold; }
+.font-italic         { font-style: italic; }
 
 // Contextual colors