From 58840620fae3d49bfa98f815a2b3058cb319c547 Mon Sep 17 00:00:00 2001
From: David Hemphill <davidlee.hemphill@gmail.com>
Date: Tue, 31 Oct 2017 12:42:12 -0500
Subject: [PATCH] Add vertical alignment docs

---
 docs/source/docs/vertical-alignment.blade.md | 93 +++++++++++++++++++-
 1 file changed, 89 insertions(+), 4 deletions(-)

diff --git a/docs/source/docs/vertical-alignment.blade.md b/docs/source/docs/vertical-alignment.blade.md
index 0c5f9ac74..871fb1315 100644
--- a/docs/source/docs/vertical-alignment.blade.md
+++ b/docs/source/docs/vertical-alignment.blade.md
@@ -5,9 +5,94 @@ title: "Vertical Alignment"
 
 # Vertical Alignment
 
-<div class="subnav">
-    <a class="subnav-link" href="#usage">Usage</a>
-    <a class="subnav-link" href="#responsive">Responsive</a>
-    <a class="subnav-link" href="#customizing">Customizing</a>
+<div class="text-xl text-slate-light mb-4">
+    Utilities for controlling the vertical alignment of an inline or table-cell box.
 </div>
 
+@include('_partials.feature-badges', [
+    'responsive' => true,
+    'customizable' => false,
+    'hover' => false,
+    'focus' => false
+])
+
+<div class="border-t border-grey-lighter">
+    <table class="w-full text-left" style="border-collapse: collapse;">
+      <colgroup>
+        <col class="w-1/5">
+        <col class="w-1/3">
+        <col>
+      </colgroup>
+        <thead>
+          <tr>
+              <th class="text-sm font-semibold text-grey-darker p-2 bg-grey-lightest">Class</th>
+              <th class="text-sm font-semibold text-grey-darker p-2 bg-grey-lightest">Properties</th>
+              <th class="text-sm font-semibold text-grey-darker p-2 bg-grey-lightest">Description</th>
+          </tr>
+        </thead>
+        <tbody class="align-baseline">
+            <tr>
+                <td class="p-2 border-t border-smoke-light font-mono text-xs text-purple-dark">.align-baseline</td>
+                <td class="p-2 border-t border-smoke-light font-mono text-xs text-blue-dark">vertical-align: baseline;</td>
+                <td class="p-2 border-t border-smoke-light text-sm text-grey-darker">Align the baseline of an element with the baseline of its parent</td>
+            </tr>
+            <tr>
+                <td class="p-2 border-t border-smoke-light font-mono text-xs text-purple-dark">.align-top</td>
+                <td class="p-2 border-t border-smoke-light font-mono text-xs text-blue-dark">vertical-align: top;</td>
+                <td class="p-2 border-t border-smoke-light text-sm text-grey-darker">Align the top of an element and its descendants with the top of the entire line.</td>
+            </tr>
+            <tr>
+                <td class="p-2 border-t border-smoke-light font-mono text-xs text-purple-dark">.align-middle</td>
+                <td class="p-2 border-t border-smoke-light font-mono text-xs text-blue-dark">vertical-align: middle;</td>
+                <td class="p-2 border-t border-smoke-light text-sm text-grey-darker">Align the middle of an element with the baseline plus half the x-height of the parent.</td>
+            </tr>
+            <tr>
+                <td class="p-2 border-t border-smoke-light font-mono text-xs text-purple-dark">.align-bottom</td>
+                <td class="p-2 border-t border-smoke-light font-mono text-xs text-blue-dark">vertical-align: bottom;</td>
+                <td class="p-2 border-t border-smoke-light text-sm text-grey-darker">Align the bottom of an element and its descendants with the bottom of the entire line.</td>
+            </tr>
+            <tr>
+                <td class="p-2 border-t border-smoke-light font-mono text-xs text-purple-dark">.align-text-top</td>
+                <td class="p-2 border-t border-smoke-light font-mono text-xs text-blue-dark">vertical-align: text-top;</td>
+                <td class="p-2 border-t border-smoke-light text-sm text-grey-darker">Align the top of an element with the top of the parent element's font.</td>
+            </tr>
+            <tr>
+                <td class="p-2 border-t border-smoke-light font-mono text-xs text-purple-dark">.align-text-bottom</td>
+                <td class="p-2 border-t border-smoke-light font-mono text-xs text-blue-dark">vertical-align: text-bottom;</td>
+                <td class="p-2 border-t border-smoke-light text-sm text-grey-darker">Align the bottom of an element with the bottom of the parent element's font.</td>
+            </tr>
+        </tbody>
+    </table>
+</div>
+
+### Tables
+
+@component('_partials.code-sample')
+  <table class="w-full">
+    <tbody>
+      <tr>
+        <td class="py-8 text-grey-darker align-baseline">Baseline text<td>
+        <td class="py-6 text-grey-darker align-top">Top-aligned text<td>
+        <td class="py-4 text-grey-darker align-middle">Middle-aligned text<td>
+        <td class="py-2 text-grey-darker align-bottom">Bottom-aligned text<td>
+      </tr>
+    </tbody>
+  </table>
+@endcomponent
+
+
+### Inline-block Elements
+
+@component('_partials.code-sample')
+<div>
+  <button class="align-middle text-blue-dark font-semibold py-2 px-4 border border-blue rounded mr-3">
+      Button
+  </button>
+  <button class="align-middle bg-blue-dark text-white text-sm font-semibold py-1 px-3 border border-blue-dark rounded-full mr-3">
+      Button
+  </button>
+  <button class="align-middle text-blue-dark font-semibold py-3 px-6 border border-blue rounded">
+      Button
+  </button>
+</div>
+@endcomponent