Add new border utils

- Move and rename .img-rounded to .rounded, .img-circle to .rounded-circle
- Add new .rounded-{direction} utils
- New docs pages for border utils with TBD comments for the border property
- Removes most image examples for rounding from the content/images docs in favor of new docs page

3 files changed, 32 insertions, 6 deletions

diff --git a/docs/_data/nav.yml b/docs/_data/nav.yml
index 835caabd7..2625e818b 100644
--- a/docs/_data/nav.yml
+++ b/docs/_data/nav.yml
@@ -55,6 +55,7 @@
 
 - title: Utilities
   pages:
+    - title: Borders
     - title: Clearfix
     - title: Close icon
     - title: Colors
diff --git a/docs/content/images.md b/docs/content/images.md
index b710fcfc5..706badf7b 100644
--- a/docs/content/images.md
+++ b/docs/content/images.md
@@ -29,19 +29,15 @@ Images in Bootstrap are made responsive with `.img-fluid`. `max-width: 100%;` an
 In Internet Explorer 9-10, SVG images with `.img-fluid` are disproportionately sized. To fix this, add `width: 100% \9;` where necessary. This fix improperly sizes other image formats, so Bootstrap doesn't apply it automatically.
 {% endcallout %}
 
-## Image shapes
+## Image thumbnails
 
-Add classes to an `<img>` element to easily style images in any project.
+In addition to our [border-radius utilities]({{ site.baseurl }}/utilities/borders/), you can use `.img-thumbnail` to give an image a rounded 1px border appearance.
 
 <div class="bd-example bd-example-images">
-  <img data-src="holder.js/200x200" class="rounded" alt="A generic square placeholder image with rounded corners">
-  <img data-src="holder.js/200x200" class="img-circle" alt="A generic square placeholder image where only the portion within the circle circumscribed about said square is visible">
   <img data-src="holder.js/200x200" class="img-thumbnail" alt="A generic square placeholder image with a white border around it, making it resemble a photograph taken with an old instant camera">
 </div>
 
 {% highlight html %}
-<img src="..." alt="..." class="rounded">
-<img src="..." alt="..." class="img-circle">
 <img src="..." alt="..." class="img-thumbnail">
 {% endhighlight %}
 
diff --git a/docs/utilities/borders.md b/docs/utilities/borders.md
new file mode 100644
index 000000000..b47d95c97
--- /dev/null
+++ b/docs/utilities/borders.md
@@ -0,0 +1,29 @@
+---
+layout: docs
+title: Borders
+group: utilities
+---
+
+Use border utilities to quickly style the `border` and `border-radius` of an element. Great for images, buttons, or any other element.
+
+## Border-radius
+
+Add classes to an element to easily round its corners.
+
+<div class="bd-example bd-example-images">
+  <img data-src="holder.js/100x100" class="rounded" alt="Example rounded image">
+  <img data-src="holder.js/100x100" class="rounded-top" alt="Example top rounded image">
+  <img data-src="holder.js/100x100" class="rounded-right" alt="Example right rounded image">
+  <img data-src="holder.js/100x100" class="rounded-bottom" alt="Example bottom rounded image">
+  <img data-src="holder.js/100x100" class="rounded-left" alt="Example left rounded image">
+  <img data-src="holder.js/100x100" class="rounded-circle" alt="Completely round image">
+</div>
+
+{% highlight html %}
+<img src="..." alt="..." class="rounded">
+<img src="..." alt="..." class="rounded-top">
+<img src="..." alt="..." class="rounded-right">
+<img src="..." alt="..." class="rounded-bottom">
+<img src="..." alt="..." class="rounded-left">
+<img src="..." alt="..." class="rounded-circle">
+{% endhighlight %}