From 51e51dc04d25c5e461b0e7e2af5f48c5baff2fd8 Mon Sep 17 00:00:00 2001
From: Adam Wathan <adam.wathan@gmail.com>
Date: Tue, 31 Oct 2017 16:52:18 -0400
Subject: [PATCH] Clean up border width and spacing docs a hair

---
 docs/source/docs/border-width.blade.md | 22 ----------------------
 docs/source/docs/spacing.blade.md      |  4 +++-
 2 files changed, 3 insertions(+), 23 deletions(-)

diff --git a/docs/source/docs/border-width.blade.md b/docs/source/docs/border-width.blade.md
index 47730ed22..10aa42c81 100644
--- a/docs/source/docs/border-width.blade.md
+++ b/docs/source/docs/border-width.blade.md
@@ -18,8 +18,6 @@ title: "Border Width"
 
 @include('_partials.work-in-progress')
 
-## Usage
-
 Add borders to any element using the `.border{-side?}{-width?}` syntax. For example, `.border` would add a `1px` border to all sides of the element, where `.border-b-4` would add a `4px` border to the bottom of the element.
 
 <div class="flex items-start mt-8 text-sm leading-none">
@@ -44,23 +42,3 @@ Add borders to any element using the `.border{-side?}{-width?}` syntax. For exam
         <div><code class="inline-block my-1 mr-1 px-2 py-1 font-mono border rounded">8</code> 8px</div>
     </div>
 </div>
-
-### Examples
-
-```html
-<!-- Add a 1px border to all sides -->
-<div class="border"></div>
-
-<!-- Add a 1px border to the top side -->
-<div class="border-t"></div>
-
-<!-- Add a 2px border to all sides -->
-<div class="border-2"></div>
-
-<!-- Add a 2px border to the top side -->
-<div class="border-t-2"></div>
-```
-
-## Responsive
-
-## Customizing
diff --git a/docs/source/docs/spacing.blade.md b/docs/source/docs/spacing.blade.md
index 19e4b975c..ec463a72a 100644
--- a/docs/source/docs/spacing.blade.md
+++ b/docs/source/docs/spacing.blade.md
@@ -18,7 +18,9 @@ title: "Padding"
 
 @include('_partials.work-in-progress')
 
-The syntax below is combined to create a system for padding and margins. For example, `.pt-2` would add padding to the top of the element to the value of `0.5rem`, `.mx-0` would make the horizontal margin zero, and `.-mb-6` would add negative margin to the bottom of an element.
+Control an element's padding and margin using the `.p{side?}-{size}`, `.m{side?}-{size}`, and `.-m{side?}-{size}` utilities.
+
+For example, `.pt-2` would add `.5rem` of padding to the top of the element, `.mx-0` would make the horizontal margin zero, and `.-mb-6` would add a `1.5rem`negative margin to the bottom of an element.
 
 <div class="flex items-start mt-8 text-sm">
     <div class="pr-12">