spec out variables customize docs

diff --git a/docs/getting-started/customize.md b/docs/getting-started/customize.md
index 72911e76e74b7429b4aa124ecc5078cccd20e511..4a2dbe1cacf2f6df3d01186923181cab62214202 100644 (file)
--- a/docs/getting-started/customize.md
+++ b/docs/getting-started/customize.md
@@ -1,16 +1,20 @@
 ---
 layout: page
-title: Customizing
+title: Customize CSS
 ---
 
-todo: this entire page
+New to Bootstrap 4, variable-based customization is a way for folks to quickly enable or disable global styles across all of Bootstrap's CSS. Simply update a variable's value and recompile using our Gruntfile.
 
-- excluding files
-  - js
-  - css
-- global SCSS settings
-  - border-radius
-  - box-shadow
-  - transitions
-  - spacer
-  - hover media queries
+## Available variables
+
+You can find and customize these variables in our `_variables.scss` file.
+
+| Variable                    | Values                             | Description                                                             |
+| --------------------------- | ---------------------------------- | ----------------------------------------------------------------------- |
+| `$spacer`                   | `1rem` (default), or any value > 0 | Specifies the default spacer value for our spacer utilities.            |
+| `$enable-flex`              | `true` or `false` (default)        | Swaps `float` and `display: table` styles for `display: flex`.          |
+| `$enable-rounded`           | `true` (default) or `false`        | Enables predefined `border-radius` styles on various components.        |
+| `$enable-shadows`           | `true` or `false` (default)        | Enables predefined `box-shadow` styles on various components.           |
+| `$enable-gradients`         | `true` or `false` (default)        | Enables predefined gradients via `background-image` various components. |
+| `$enable-transitions`       | `true` (default) or `false`        | Enables predefined `transition`s on various components.                 |
+| `$enable-hover-media-query` | `true` or `false` (default)        | ...                                                                     |